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虽然 我 从 事 Android 开 发 工作 已 经 很 多 年 了 ,但 是 之 前 从 来 没有 想 过 自己 要 去 写 一 本 Android 
技术 相关 的 书 。 在 我 看 来 ， 写 一 本 书 可 以 算是 一 个 很 庞大 的 工程 ， 写 一 本 好 书 的 难度 并 不 亚 于 开 
发 一 款 好 的 应 用 程序 。 

由 于 我 长 期 坚持 在 CSDN 上 发 表 技术 博文 ， 因 而 得 到 了 大 量 网 友 的 认可 ， 也 积累 了 一 定 的 名 
气 。 很 荣幸 的 是 ， 人 民 邮 电 出 版 社 图 灵 公 司 的 前 副 总 编辑 陈 冰 老师 联系 上 了 我 , 希望 我 可 以 写 一 
本 关于 Android 开 发 技术 的 书 ， 这 着 实 让 我 受宠若惊 。 

在 写本 书 第 1 版 的 时 候 ， 我 可 以 说 是 费 了 相当 大 的 心思 。 写 书 和 写 博 客 最 大 的 区 别 在 于 ， 书 
的 内 容 不 能 像 博 客 那样 散乱 ， 不 能 想到 哪里 写 到 哪里 ， 而 是 一 定 要 系统 化 ， 要 循序 渐进 ， 基 本 上 
在 写 第 1 章 的 时 候 就 应 该 把 全 书 的 内 容 都 确定 下 来 了 。 

令 我 非常 欣慰 的 是 ， 本 书 的 第 1 版 在 推出 之 后 获得 了 广大 读者 的 强烈 认可 ， 在 短 短 两 年 时 间 
内 ， 已 经 成 为 了 国内 最 畅销 的 Android 技 术 书 。 各 大 书店 、 图 书馆 都 能 看 到 《第 一 行 代码 》 的 身 
影 ， 许 多 学 校 和 培训 机 构 也 纷纷 将 《第 一 行 代码 》 选 为 Android 课 程 的 教材 。 

不 过 ， 在 科技 高 速 发 展 的 今天 ， 各 种 技术 的 发 展 都 是 日 新 月 异 的。 在 两 年 的 时 间 里 ，Android 
操作 系统 经 历 了 $.0、6.0、7.0 的 飞速 升级 。 不 可 否认 的 是 ， 本 书 第 1 版 中 的 不 少 知识 点 都 已 经 过 时 ， 
而 且 这 两 年 间 出 现 的 很 多 新 知识 , 第 1 版 中 也 没有 涵盖 。 因此 , 这 让 我 坚定 了 写作 本 书 第 2 版 的 想法 。 

刚 开 始 写 的 时 候 , 我 以 为 只 是 小 修 小 补 , 但 事实 上 并 没有 我 想象 得 那么 轻松 。 除 了 介绍 新 知 
识 点 以 外 , 书 中 之 前 的 所 有 项 目 都 需要 重新 编写 和 测试 ， 以 保证 代码 在 新 老 系统 上 的 兼容 性 。 另 
外 , 由 于 Android 从 5.0 系 统 开 始 ，UI 风 格 变化 很 大 ， 因 此 第 1 版 中 所 有 的 截图 都 需要 更 新 。 训 不 夸 
张 地 说 ， 我 几乎 重 写 了 整 本 书 。 

而 现在 , 你 手中 捧 着 的 正 是 全 新 版 的 《第 一 行 代码 》 同时 这 也 是 国内 第 一 本 基于 Android 7.0 
系统 写作 的 技术 书 。 我 真诚 地 希望 你 可 以 用 心 去 阅读 这 本 书 ， 因 为 每 多 掌握 一 份 知识 ,你 就 会 多 
一 份 喜悦 。Enjoy it! 


第 2 版 的 变化 


由 于 第 2 版 修改 内 容 繁 多 ， 因 此 这 里 我 只 列举 出 最 主要 的 变化 。 首 先是 开发 工具 上 的 改变 ， 
本 书 第 1 版 使 用 的 开发 工具 是 Eclipse， 而 第 2 版 使 用 了 目前 最 新 的 Android Studio 2.2 版 本 。 另 外 ， 


本 书 第 1 版 是 基于 Android 4.x 系 统 的 ， 而 第 2 版 是 基于 Android 7.0 系 统 的 ， 其 中 澡 括 了 新 系统 中 的 
诸多 知识 点 , 包括 Android 5.0 系 统 中 引入 的 Material Design、Android 6.0 系 统 中 引入 的 运行 时 权限 
和 Doze 模 式 、Android 7.0 系 统 中 引入 的 多 窗口 模式 等 。 


除 此 之 外 ,第 2 版 还 加 入 了 Gradle、RecyclerView、 百 分 比 布局 、OkHttp、Lambda 表 达 式 等 全 
新 知识 点 的 讲解 ， 内 容 将 前 所 未 有 地 充实 。 


读者 对 象 


本 书 内 容 通 俗 易 懂 ， 由浅 入 深 ， 既 适合 初学 者 阅读 ， 也 同样 适合 专业 人 员 。 学 习 本 书 内 容 之 
前 ， 你 并 不 需要 有 任何 的 Android 基 础 ， 但 是 你 需要 有 一 定 的 Java 基 础 ， 因 为 Android 开 发 都 是 使 
用 Java 语 言 的 ， 而 本 书 并 不 会 去 专门 介绍 Java 方 面 的 知识 。 

阅读 本 书 时 ， 你 可 以 根据 自身 的 情况 来 决定 如 何 阅 读 。 如 果 你 是 初学 者 的 话 ， 建 议 你 从 第 1 
章 开 始 循序 渐进 地 阅读 ， 这 样 理 解 起 来 就 不 会 感到 吃力 。 而 如 果 你 已 经 有 了 一 定 的 Android 基 础 ， 
那么 就 可 以 选择 某 些 你 感 兴趣 的 章节 进行 跳跃 式 的 阅读 。 但 请 记 住 , 很 多 章 最 后 的 最 佳 实践 部 分 
一 定 是 你 不 想 错 过 的 。 


本 书 内 容 


正如 前 面 所 说 ,本 书 的 内 容 是 非常 系统 化 的 ,不 仅 全 面 介 绍 了 那些 你 必须 掌握 的 知识 ， 而 且 
保证 了 各 章 的 难度 都 是 梯度 式 上 升 的 。 全 书 一 共 分 为 1$ 章 ， 涵 盖 了 四 大 组 件 、UI、 碎 片 、 数 据 存 
储 、 多 媒体 、 网 络 、 定 位 服务 等 方方面面 的 知识 。 为 了 让 你 在 学 完 所 有 内 容 之 后 还 可 以 有 综合 运 
用 的 能 力 , 本 书 的 尾声 部 分 还 会 带 你 一 起 开发 一 个 天 气 预报 程序 ,并 教会 你 如 何 将 程序 发 布 到 应 
用 商店 ， 以 及 如 何在 程序 中 舰 入 广告 租 利 。 

除 此 之 外 ， 本 书 的 第 5 章 、 第 7 章 、 第 11 章 、 第 14 章 中 都 穿插 有 对 Git 的 讲解 ， 如 果 想 要 掌握 
它 的 用 法 ， 这 几 章 的 内 容 是 绝对 不 能 错过 的 。 

本 书 中 各 个 章节 的 内 容 都 相对 比较 独立 , 因此 除了 可 以 循序 渐进 地 学 习 之 外 , 你 还 可 以 
当成 一 本 参考 手册 ， 随 时 查阅 。 


它 


车 


源码 下 载 

首先 , 我 建议 你 在 学 习 本 书 的 时 候 将 所 有 项 目的 源码 都 亲手 敲 上 一 遍 , 因为 只 有 这 样 才能 加 
深 你 对 代码 的 理解 。 不 过 为 了 方便 于 你 的 学 习 , 我 还 是 提供 了 书 中 所 有 项 目的 源码 ,请 仅 在 需要 
的 时 候 再 去 参考 ( 如 下 载 项 目 中 的 图 片 资源 )。 切 勿 直接 将 源码 复制 粘贴 就 当成 自己 的 东西 了 ， 
只 有 亲手 敲 过 的 代码 才 真 正 是 你 自己 的 。 

源码 下 载 地 址 : https://github.com/guolindev/booksource。 


至 


谢 


在 这 近 一 年 的 时 间 里 ,我 又 完成 了 一 项 浩大 的 工程 。 和 写作 本 书 第 1 版 时 的 感觉 类 似 ， 当 全 


书 完稿 之 后 ， 回 顾 整 本 书 ， 我 仍然 不 敢 相信 这 所 有 的 内 容 竞 然 是 我 一 字 字 地 斋 出 来 的 。 


如 今 这 已 经 是 我 写 的 第 二 本 书 了 ， 和 写 第 一 本 书 时 的 情况 不 同 ， 现 在 我 有 了 更 广 的 人 脉 和 
资源 ， 有 了 更 多 的 人 愿意 帮助 和 支持 我 来 完成 一 本 更 好 的 技术 书 。 因 此 ， 我 要 在 这 里 对 很 多 人 


表示 感谢 。 


首先 我 要 感谢 我 的 父母 ， 感 谢 你 们 将 我 抚养 长 大 ， 感 谢 你 们 的 付出 ， 让 我 从 小 不 用 为 生计 、 


上 学 而 发 愁 ， 可 以 一 直 做 我 自己 想 做 的 事情 ， 也 感谢 


其 次 我 要 感谢 我 包 


平日 的 加 班 还 是 没 日 没 夜 的 写 书 ， 你 都 一 直 默 默 地 理解 和 支持 我 。 
我 还 非常 感谢 本 书 第 1 版 的 编辑 陈 冰 老 师 , 如 果 没 有 你 当初 在 CSDN 上 找到 我 ,并 邀请 我 写 书 ， 


另外 我 还 要 特别 感谢 一 部 分 人 ,你 们 在 对 本 书 的 内 容 建 议 、 


个 坚信 这 本 书 


就 不 会 有 现在 的 《第 一 行 代码 六 另外 ， 你 也 是 当时 唯 
连 我 自己 当时 都 没有 如 此 的 眼光 。 
我 也 非常 感谢 本 书 第 2 版 的 编辑 张 霞 , 你 全 程 负责 了 第 2 版 的 出 版 工作 ,并 | 


你 们 指引 我 走 上 了 技术 这 条 路 。 
妻子 ， 感 谢 你 每 天 为 我 准备 好 一 日 三 餐 ， 感谢 你 对 我 永远 的 包容 , 不管 是 


定 会 大 卖 的 人 ， 甚 至 


是 完成 得 非常 出 色 。 
你 对 文字 的 把 控 能 力 让 我 敬佩 ,感谢 你 对 书 中 每 一 音节 的 尽心 审阅 ,才能 让 这 本 书 更 趋 近 于 完美 。 


勘误 检查 、 代 码 纠 错 ， 甚 至 是 对 


我 个 人 的 支持 等 方面 都 作出 了 卓越 的 贡献 。 有 了 你 们 的 帮助 , 才 会 有 这 样 一 本 更 加 出 色 的 书 呈 现 
在 所 有 人 面前 ， 这 本 书 上 也 理应 有 你 们 的 名 字 ( 按 姓氏 拼音 排序 ， 排 名 不 分 先后 ): 
代 云 蚁 
李 济 洲 
陆 德 俊 
王 路 路 


陈 建 林 “ 陈 俊杰 
高 钨 泉 高 太 稳 
李 潭 李 永 及 
马 文 杰 。 草 文 让 
王 善 昌 韦 振 南 
张 鸿 洋 “ 张 英 祥 


十 一 
JU 


会 


陈 龙 
何以 诚 
林 火 荣 
王 柏 强 


陈 琪 
胡 恩泽 
刘 萌 
王 光 东 


陈 秀 相 
黄 楠 
刘 明 浏 
SN 


陈 逸 鸣 
赖 帆 
刘 治 国 
王 龙 


董 霖 轩 


李 建 友 


段 郭 森 


李 沛 明 


吴 宏 权 
赵 庆 元 


[= ex 
吴 绍 4D 


赵 迎 超 


徐 阳 
郑 传 书 


轩 仲 宽 


杨 


郑 敏 馨 


庄 


育 锋 


第 1 章 ”开始 启程 一 一 你 的 第 一 行 

Android 代码 eee 1 

1.1 了 解 全 貌 一 一 Android 王国 简介 …………… 2 
1.1.1 Android 系统 架构 和 pp 人 
1.1.2 Android 已 发 布 的 版 本 pp 3 
1.1.3 Android 应 用 开发 特色 ppp 4 

1.2 ”手把手 带 你 搭建 开发 环境 ………… 5 
1.2.1 准备 所 需要 的 工具 ppp 5 
1.2.2 ”搭建 开发 环境 5 

1.3 创建 你 的 第 一 个 Android 项 目 …………… 9 
1.3.1 创建 HelloWorld 项 目 和 pp 9 

1.3.2 启动 模拟 器 12 
1.3.3 运行 HelloWorld PP 15 
1.3.4 分 析 你 的 第 一 个 Android 程序 …16 
1.3.5 详解 项 目 中 的 资源 .ppp 22 
1.3.6 详解 build.gradle 文件 pp 23 

1.4 前 行 必 备 一 一 掌握 日 志 工 具 的 使 用 ……26 


1.5 


1.4.1 使 用 Android 的 日 志 工 具 Log …26 
1.4.2 为 什么 使 用 Log 而 不 使 用 


System.out es 27 
小 结 与 点 评 29 


第 2 章 先 从 看 得 到 的 入 手 一 一 探究 


2.1 
和 .2 


活动 30 
活动 是 什 委 站 30 
活动 的 基本 用 法 30 
2.2.1 手动 创建 活动 和 31 
2.2.2 创建 和 加 载 布 局 32 


之 


2.4 


人 .5 


2.0 


2 


2.2.3 在 AndroidManifest 文件 中 

注册 evened 35 
2.2.4 ”在 活动 中 使 用 Toast ee 37 
2.2.5 在 活动 中 使 用 Menu PP 38 
2.2.6 销毁 一 个 活动 站 40 
使 用 Intent 在 活动 之 间 穿 权 41 
2.3.1 使 用 显 式 Intenteeeeeeeeeeeeeeeeeeenne 41 
2.3.2 ”使 用 隐 式 Intenteeeeeeeeeeeeeeeeeenenee 44 
2.3.3 更 多 隐 式 Intent 的 用 法 ……… 46 
2.3.4 ”向 下 一 个 活动 传递 数据 …… 50 
2.3.5 ”返回 数据 给 上 一 个 活动 ……… 931 
活动 的 生命 周期 pp 53 
2.4.1 和 返 国 栈 53 
2.4.2 活动 状 想 站 RN 54 
2.4.3 活动 的 生存 期 pe 5 
2.4.4 ”体验 活动 的 生命 周期 ……………… 56 
2.4.5 ”活动 被 回收 了 怎么 办 ene 62 
活动 的 启动 模式 63 
.51 Standard era 64 
2.5.2 singleTop ee 65 
2.5.3 singleTask ee 67 
2.5.4 singleInstance eee 68 
活动 的 最 佳 实践 ………… 71 
2.6.1 知晓 当前 是 在 哪 一 个 活动 ………… 71 
2.6.2 ”随时 随地 退出 程序 pp 52 
2.6.3 ”启动 活动 的 最 佳 写 法 .PP 74 
小 缚 与 点 评 ee 75 


目 录 vii 
第 3 章 ”软件 也 要 拼 脸 蛋 一 一 UI 开发 的 第 4 章 手机 平板 要 兼顾 一 一 探究 
点 点 滴 清 和 76 人 碎片 和 142 
3.1 如 何 编写 程序 界面 和 RN 76 站 1， 个 应 是 什 公 Dm 142 
3.2 ”常用 控件 的 使 用 方法 ee 77 4.2 碎片 的 使 用 方式 Ne 144 
3 1 TEXtVieW mi 77 4.2.1 碎片 的 简单 用 法 een， 144 
D0 DUO 80 4.2.2 动态 添加 碎片 pe 147 
.9 3. BditT et 82 4.2.3 ”在 碎片 中 模拟 返回 栈 ……………… 150 
3.2.4 ImageVieW ee 86 4.2.4 ”碎片 和 活动 之 间 进 行 通信 ……… 151 
3.2.5 ProgressBar ee 88 4.3 ”碎片 的 生命 周期 和 151 
3.2.6 AlertDialog 91 4.3.1 碎片 的 状态 和 回调 pp 151 
3.2.7 ProgressDialog ee 93 4.3.2 ”体验 碎片 的 生命 周期 ……… 153 
3.3 详解 4 种 基本 布局 -ee 94 4.4 动态 加 载 布局 的 技巧 和 156 
3.3.1 线性 渍 局 5 94 4.4.1 使 用 限定 符 交 PP 156 
3.3.2 相对 布局 Pe eo ee 100 ot edd A SA 159 
Eve Wb ee 103 4.5 bn 的 最 佳 实践 一 一 个 简易 版 的 
ne 1 新 闻 应 | 有 有 160 
4.6 “小 结 与 点 评 和 es 169 
3.4 系统 控件 不 够 用 ? 创建 自 定义 控件 ……108 
3.4.1 引入 布局 和 109 第 5 章 全 局 大 喇叭 一 详解 广播 
3.4.2 ”创建 自 定义 控件 和 111 机 出 ep 170 
9 i 5 个 括 机 制 人 简介 170 
Nd en 113 0 se 人 
3.5.1 ListView 的 简单 用 法 eee 114 5.2.1 动态 注册 监听 网 络 变 化 …………… 171 
3.5.2 定制 ListView 的 界面 Bl 5.2.2 静态 注册 实现 开机 启动 ………… 174 
3.5.3 提升 ListView 的 运行 效率 ……119 53 发送 自 定义 广播 eeneennnneennnn， 177 
3.5.4 ListView 的 点 击 事件 pp 120 5.3.1 发 送 标准 广播 :pe 177 
3.6 更 强大 的 深 动 控件 一 一 Recycler S32 改进 有 省 广播 让 179 
NO 122 5.4 ”使 用 本 地 广播 ……………eeeeeeeeeeeceeeneee 183 
3.6.1 RecyclerView 的 基本 用 法 ……… 122 5.5 广播 的 最 佳 实践 ~ 实现 强制 下 线 
3.6.2 ”实现 横向 滚动 和 瀑布 流 布 局 …… 125 | 185 
3.6.3 ”RecyclerView 的 点 击 事件 ……… 130 5.6 Git 时 间 一 一 初 识 版 本 控制 工具 ……… 192 
3.7 ”编写 界面 的 最 佳 实践 ………………… 132 5.6.1 安装 Giteeeeeeeeeeeeee. 192 
3.7.1 制作 Nine-Patch 图 片 …………………………… 132 5.6.2 ”创建 代码 仓库 和 ppp 193 
3.7.2 ”编写 精美 的 聊天 界面 …………… 135 5.6.3” 提交 本 地 代码 195 
ee 141 A A 195 


Vili 目 录 


第 6 章 数据 存储 全 方案 一 一 详解 7.3 ”访问 其 他 程序 中 的 数据 ………………… 254 
持久 化 技术 ……… 196 7.3.1 ContentResolver 的 基本 用 法 ……254 
6 持 类 化 技 坟 简 认 boob 196 7.3.2 ” 读 取 系统 联系 人 ee 和 eeenn* 256 
6.2 文件 存储 197 7.4 ”创建 自己 的 内 容 提供 器 …………………… 260 
6.2.1 将 数据 存储 到 文件 中 …………… 197 7.4.1 创建 内 容 提 供 器 的 步骤 ………… 261 
6.2.2 ”从 文件 中 读 取 数 据 .pp 201 7.4.2 ”实现 跨 程 序数 据 共享 ……………… 265 
63 ”SharedPreferences 存储 和 203 7.5 ”Git 时 间 版 本 控制 工具 进 阶 ………… 275 
6.3.1 将 数据 存储 到 SharedPrefe 7.5.1] 忽略 文件 Ne 275 
A 203 7.5.2 ”查看 修改 内 容 症 pp 276 
6.3.2 ”从 SharedPreferences 中 读 取 7.5.3 撤销 未 提交 的 修改 278 
入 所 206 7.5.4 查看 提交 记录 和 pe 279 
6.3.3 实现 记 住 客 码 功能 :pp 208 7.6 小结 与 点 评 280 

”| 第 8 章 让 富 你 的 程序 一 运用 手机 
Ce 多 媒体 281 
3 219 8.1 将 程序 运行 到 手机 上 281 
0 下 现 者 娄 找 222 8.2 ”使 用 通知 283 
6.4.5 删除 数据 站 224 8.2.1 通知 的 基本 用 法 和 pe 283 
6 未 人 “查询 数 振 生生 二 225 8.2.2 ”通知 的 进 阶 技巧 esseeeeeeeeeee 289 
6.4.7 使 用 SQL 操作 数据 库 ………… 228 8.2.3 通知 的 高 级 功能 ppp 291 
6.5 使 用 LitePal 操作 数据 库 .pp 229 8.3 ”调用 摄像 头 和 相册 PP 293 
ES “LiteBal 简 外 wooo: 229 8.3.1 调用 摄像 头 拍 照 ……… 294 
6.52 配置 LitePal eee 230 8.3.2 ”从 相册 中 选择 照片 ppp 298 
6.5.3 ”创建 和 升级 数据 库 …………… 231 8.4 播放 多 媒体 文件 和 303 
6.5.4 使 用 LitePal 添加 数据 .4 236 8.4.1 播放 音频 和 Ne 303 
6.5.5 使 用 LitePal 更 新 数据 …………… 237 8.4.2 ”播放 视频 和 307 
6.5.6 使 用 LitePal 删除 数据 ………… 240 8.5 ”小 结 与 点 评 eeseeeses 和 nenesnsenen 311 

; 询 数 据 … 
bh kh 4， 第 9 意 看 看 精彩 的 世界 一 使 用 

网 络 技术 ene 312 
第 7 章 ” 跨 程 序 共享 数据 一 一 探究 0: ,EDVIOW I eta 312 
内 容 提 供 器 人 244 9.2 ”使 用 HTTP 协议 访问 网 络 ………………… 314 
7.1 ”内容 提 供 器 简介 ……………… 244 9.2.1 使 用 HttpURLConnection……… 315 
7 人 运行 时 权限 245 9.2.2 ”使 用 OKHttp 和 319 
7.2.1 Android 权限 机 制 详解 ………… 245 9.3 解析 XML 格式 数据 Ne 321 


7.2.2 ”在 程序 运行 时 申请 权限 :pp 249 9.3.1 Pull 解析 方式 和 324 


目 录 这 


9.3.2 SAX 解析 方式 pe 326 
9.4 解析 JSON 格式 数据 329 
9.4.1 使 用 JSONObject pp 330 
9.4.2 使 用 GSON eee 331 
9.5 ”网 络 编程 的 最 佳 实践 …………… 334 
9.6 “小 结 与 点 评 ee 338 
第 10 章 ， 后台 默 默 的 劳动 者 一 探究 
服务 es 339 
10.1 服务 是 什 委 和 339 
10.2 Android 多 线程 编程 340 
10.2.1 线程 的 基本 用 法 和 pp 340 
10.2.2 ”在 子 线程 中 更 新 UI……… 341 
10.2.3 ”解析 异步 消息 处 理 机 制 ……… 345 
10.2.4 使 用 AsyncTask 
10.3 ”服务 的 基本 用 法 …………… 
10.3.1 定义 一 个 服务 .pp 
10.3.2 ”启动 和 停止 服务 
10.3.3 ”活动 和 服务 进行 通信 ………… 355 
10.4 ”服务 的 生命 周期 pp 359 
10.5 服务 的 更 多 技巧 和 359 
10.5.1 使 用 前 台 服 务 ……eeeeeeee。 359 
10.5.2 ”使 用 IntentService ee 361 
10.6 服务 的 最 佳 实践 一 一 完整 版 的 下 载 
示例 ……… en 
10.7 小结 与 点 评 


第 11 章 ” Android 特色 开发 一 一 基于 


11.1 
11.2 
11.3 


位 置 的 服务 imi 379 
基于 位 置 的 服务 简介 …………… 379 
申请 API Key 380 
使 用 百度 定位 ……………………… 384 
11.3.1 准备 LBS SDK…eeeeeeeennnee 384 
11.3.2 ”确定 自己 位 置 的 经 纬度 ……… 386 
11.3.3 选择 定位 模式 


看 得 懂 的 位 置信 息 ………… 393 


11.4 


11.5 


11.6 


使 用 百度 地 图 395 
11.4.1 让 地 图 显示 出 来 enn。 395 
11.4.2 ”移动 到 我 的 位 置 ……eeen……。 397 
11.4.3 ”让 “我 "显示 在 地 图 上 …………… 400 
Git 时 间 一 一 版 本 控制 工具 的 高 级 
法 402 
11.5.1 分支 的 用 法 pe 403 
11.5.2 与 远程 版 本 库 协作 ……………… 404 
小 结 与 点 评 406 


第 12 章 最 佳 的 Ul 体验 一 一 Material 


Design ES RE 407 

12.1 什么 是 Material Design 和 pp 407 
下 408 
17 了 清 动 荣 蓝 ee 415 
12.3.1 DrawerLayout 和 ee 415 
12.3.2 NayigationVieW pp 418 

12.4 悬浮 按钮 和 可 交互 提示 423 
12.4.1 FloatingActionButton PP 424 
12.4.2 Snackbareeeee 427 
12.4.3 CoordinatorLayout ee 428 

12.5 ”卡片 式 布局 eeeeeeeeeeeeeeenenee 430 
12.5.1 CardVieWw ee 431 
12.5.2 AppBarLayout ee 437 

12.6 ”下 拉 刷 新 站 440 
12.7 可 折 欠 式 标题 栏 …… 443 
12.7.1 CollapsingToolbarLayout ……… 443 
12.7.2 ”充分 利用 系统 状态 栏 空间 ……453 

1 人 8 一 水 结 与 点 评 ee 456 

第 13 章 ”继续 进 阶 一 一 你 还 应 该 掌握 

的 高 级 技巧 和 457 

13.1 全 局 获取 Context 的 技巧 …………………… 457 
13.2 ”使 用 Intent 传递 对 象 …………… 461 
13.2.1 Serializable 方式 een: 461 
13.2.2 ”Parcelable 方式 enn, 463 


X 目 录 
13.3 ”定制 自己 的 日 志 工 具 PP 464 14.5.4 ”获取 必 应 每 日 一 图 …………… 526 
13.4 调试 Android 全。 eae 466 14.6 ”手动 更 新 天 气 和 切换 城市 ……………… 532 
13.5 ”创建 定时 任务 469 14.6.1 手动 更 新 天 和 气 和 pp 532 
13.5.1 Alarm 机 制 站 469 14.6.2” 蕊 换 城 市 535 
13.5.2 ”Doze 模式 站 471 14.7 后台 自动 更 新 天 和 气 和 Ne 540 
13.6 ”多 窗口 模式 编程 和 472 14.8 ”修改 图 标 和 和 名称 542 
13.6.1 进入 多 窗口 模式 enn。 473 14.9 ”你 还 可 以 做 的 事情 543 
13.6.2 多 窗口 模式 下 的 生命 周期 ……475 
13.6.3 ”禁用 多 窗口 模式 和 ppp 479 第 15 章 最 后 一 
13.7 Lambda 表达 式 站 481 360 应 用 ee Ss 545 
13.8 总结 485 15.1 生成 正式 签名 的 APK 文件 PP 545 
15.1.1 使 用 Android Studio 生成 ……546 
第 14 章 进入 实战 一 一 开发 酷 欧 15.1.2 使 用 Gradle 生成 eco。 548 
天 486 15.1.3 生成 多 渠道 AP 区 文件 | 
14.1 ”功能 需求 及 技术 可 行 性 分 析 …………… 486 15.2 ”申请 360 开发 者 账号 pp 554 
14.2 ”Git 时 间 将 代码 托管 到 15.3 ”发 布 应 用 程序 556 
GitHub Eee 489 15.4 ”散人 入 广告 进行 仍 利 ………………… 560 
14.3 ”创建 数据 库 和 表 494 15.4.1 ”注册 腾讯 广告 联盟 账号 ……… 560 
14.4 ”遍历 全 国 省 市 县 数据 …………… 499 15.4.2 ”新 建 媒体 和 广告 位 ……………… 562 
14.5 显示 天 和 气 信 息 509 15.4.3” 接 入 广告 SDK econnee 564 
14.5.1 定义 GSON 实体 类 …… 509 15.4.4 重新 发 布 应 用 程序 …… 569 
14.5.2 ”编写 天 气 界面 pe 514 1 二 5 结束语 生 570 
14.5.3 ”将 天 气 显示 到 界面 上 ……… 520 


入 和 人 1 sy 


下 1 时 


开始 局 程 一 一 你 的 第 一 行 Android 代码 


欢迎 你 来 到 Android 世界 ! Android 系统 是 目前 世界 上 市 场 占有 率 最 高 的 移动 操作 系统 ， 不 
管 你 在 哪里 ， 都 可 以 看 到 Android 手机 几乎 无 处 不 在 。 今 天 的 Android 世界 可 谓 欣 欣 向 荣 ， 可 是 
你 知道 它 的 过 去 是 什么 样 的 吗 ? 我 们 一 起 来 看 一 看 它 的 发 展 史 吧 。 

2003 年 10 月 ，Andy Rubin 等 人 一 起 创办 了 Android 公司 。2005 年 8 月 谷歌 收购 了 这 家 仅仅 
成 立 了 22 个 月 的 公司 ， 并 让 Andy Rubin 继续 负责 Android 项 目 。 在 经 过 了 数 年 的 研发 之 后 ， 谷 
歌 终 于 在 2008 年 推出 了 Android 系统 的 第 一 个 版 本 。 但 自 那 之 后 ，Android 的 发 展 就 一 直 受 到 重 
重 阻挠 。 乔 布 斯 自始至终 认为 Android 是 一 个 抄袭 iPhone 的 产品 ， 里 面 肌 窃 了 诸多 iPhone 的 创 
意 ， 并 声称 一 定 要 毁 掉 Android。 而 本 身 就 是 基于 Linux 开发 的 Android 操作 系统 ， 在 2010 年 被 
Linux 团队 从 Linux 内 核 主 线 中 除名 。 又 由 于 Android 中 的 应 用 程序 都 是 使 用 Java 开发 的 ， 甲 骨 
文 则 针对 Android 侵犯 Java 知识 产权 一 事 对 谷歌 提起 了 诉讼 …… 

可 是 ,似乎 再 多 的 困难 也 阻挡 不 了 Android 快速 前 进 的 步伐 。 由 于 谷歌 的 开放 政策 ， 任 何 手 
机 厂商 和 个 人 都 能 免费 获取 到 Android 操作 系统 的 源码 ,并 且 可 以 自由 地 使 用 和 定制 .三 星 .HTC、 
摩托 罗拉 、 索 爱 等 公司 都 推出 了 各 自 系 列 的 Android 手机 ，Android 市 场 上 百花 齐 放 。 仅 仅 推出 
两 年 后 ，Android 就 超过 了 已 经 霸占 市 场 逾 十 年 的 诺基亚 Symbian ， 成 为 了 全 球 第 一 大 智能 手机 
操作 系统 ,并 且 每 天 都 还 会 有 数 百 万 台新 的 Android 设备 被 激活 。 而 近 几 年 ， 国 内 的 手机 厂商 也 
是 大 放 异 彩 ， 小 米 、 华 为 、 魅 族 等 新 兴 品 牌 都 推出 了 相当 不 错 的 Android 手 机， 并 且 也 获得 了 市 
场 的 广泛 认可 ， 目 前 Android 已 经 占据 了 全 球 智 能 手机 操作 系统 70% 以 上 的 份额 。 

说 了 这 些 ， 想 必 你 已 经 体会 到 Android 系统 炙手可热 的 程度 ， 并 且 人 迫不及待 地 想 要 加 入 到 
Android 开发 者 的 行列 当中 了 吧 。 试 想 一 下 ， 十 个 人 中 有 七 个 人 的 手机 都 可 以 运行 你 编写 的 应 用 
程序 ， 还 有 什么 能 比 这 个 更 诱 人 的 呢 ? 那么 从 今天 起 ， 我 就 带 你 踏 上 学 习 Android 的 旅途 ， 一步 
步 地 引导 你 成 为 一 名 出 色 的 Android 开发 者 。 

好 了 ， 现 在 我 们 就 来 一 起 初 突 一 下 Android 世界 吧 。 


2 第 1 章 开始 启程 一 一 你 的 第 一 行 Android 代码 


1.1 了 解 全 貌 一 一 Android 王国 简介 


Android 从 面世 以 来 到 现在 已 经 发 布 了 二 十 几 个 版 本 了 。 在 这 几 年 的 发 展 过 程 中 ， 谷 歌 为 
Android 王国 建立 了 一 个 完整 的 生态 系统 。 手 机 厂商 、 开 发 者 、 用 户 之 间 相 互 依存 ， 共 同 推进 着 
Android 的 蓬勃 发 展 。 开 发 者 在 其 中 扮演 着 不 可 或 缺 的 角色 ， 因 为 如 果 没 有 开发 者 来 制作 丰富 的 
应 用 程序 , 那么 不 管 多 么 优秀 的 操作 系统 ,也 是 难以 得 到 大 众 用 户 喜 爱 的 , 相信 没有 多 少 人 能 够 
忍受 没有 QQ、 微 信 的 手机 吧 。 而 且 ， 谷歌 推出 的 Google Play 更 是 给 开发 者 带 来 了 大 量 的 机 遇 ， 
只 要 你 能 制作 出 优秀 的 产品 ， 在 Google Play 上 获得 了 用 户 的 认可 ， 你 就 完全 可 以 得 到 不 错 的 经 
济 回报 ， 从 而 成 为 一 名 独立 开发 者 ， 甚 至 是 成 功 创业 ! 

那 我 们 现在 就 以 一 个 开发 者 的 角度 ， 去 了 解 一 下 这 个 操作 系统 吧 。 纯 理论 型 的 东西 也 比较 
无 聊 ， 怕 你 看 睡 着 了 ， 因 此 我 只 挑 重点 介绍 ， 这 些 东 西 跟 你 以 后 的 开发 工作 都 是 息息相关 的 。 


1.1.1 Android 系统 架构 

为 了 让 你 能 够 更 好 地 理解 Android 系统 是 怎么 工作 的 ， 我们 先 来 看 一 下 它 的 系统 架构 。 
Android 大 致 可 以 分 为 四 层 架 构 : Linux 内 核 层 、 系 统 运 行 库 层 、 应 用 框架 层 和 应 用 层 。 

1. Linux 内 核 层 

Android 系统 是 基于 Linux 内 核 的 , 这 一 层 为 Android 设备 的 各 种 硬件 提供 了 底层 的 驱动 , 如 
显示 驱动 、 音 频 驱 动 、 照 相机 驱动 、 蓝 牙 驱 动 、Wi-Fi 驱动 、 电 源 管理 等 。 

2. 系统 运行 库 层 

这 一 层 通过 一 些 C/C++ 库 来 为 Android 系统 提供 了 主要 的 特性 支持 ,如 SQLite 库 提 供 了 数据 
库 的 支持 ，OpenGLIES 库 提 供 了 3D 绘图 的 支持 ，Webkit 库 提 供 了 浏览 器 内 核 的 支持 等 。 

同样 在 这 一 层 还 有 Android 运行 时 库 ， 它 主要 提供 了 一 些 核心 库 ， 能 够 允许 开发 者 使 用 Java 
语言 来 编写 Android 应 用 。 另 外 ，Android 运行 时 库 中 还 包含 了 Dalvik 虚拟 机 ( $.0 系统 之 后 改 为 
ART 运行 环境 )， 它 使 得 每 一 个 Android 应 用 都 能 运行 在 独立 的 进程 当中 ， 并 且 拥 有 一 个 自己 的 
Dalvik 虚拟 机 实例 。 相 较 于 Java 虚拟 机 ，Dalvik 是 专门 为 移动 设备 定制 的 ， 它 针对 手机 内 存 、 
CPU 性 能 有 限 等 情况 做 了 优化 处 理 。 

3. 应 用 框架 层 

这 一 层 主要 提供 了 构建 应 用 程序 时 可 能 用 到 的 各 种 API，Android 自 带 的 一 些 核心 应 用 就 是 
使 用 这 些 API 完 成 的 ， 开 发 者 也 可 以 通过 使 用 这 些 API 来 构建 自己 的 应 用 程序 。 

4. 应 用 层 

所 有 安装 在 手机 上 的 应 用 程序 都 是 属于 这 一 层 的 ， 比 如 系统 自 带 的 联系 人 、 短 信 等 程序 , 或 
者 是 你 从 Google Play 上 下 载 的 小 游戏 ， 当 然 还 包括 你 自己 开发 的 程序 。 

结合 图 1.1 你 将 会 理解 得 更 加 深刻 ， 图 片 源 自 维基 百科 。 
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APPLICATIONS 


Phone Browser 


LIBRARIES 


Media 
Framework 


FreeType 


SC 


图 1.1 Android 系统 架构 


1.1.2 Android 已 发 布 的 版 本 


2008 年 9 月 ， 谷 歌 正式 发 布 了 Android 1.0 系统 ， 这 也 是 Android 系统 最 早 的 版 本 。 随 后 的 
几 年 ， 谷 歌 以 惊人 的 速度 不 断 地 更 新 Android 系统 ，2.1 、2.2、2.3 系统 的 推出 使 Android 占据 了 
大 量 的 市 场 。2011 年 2 月 ， 谷 歌 发 布 了 Android 3.0 系统 ， 这 个 系统 版 本 是 专门 为 平板 电脑 设计 
的 ， 但 也 是 Android 为 数 不 多 的 比较 失败 的 版 本 ,推出 之 后 一 直 不 见 什 么 起 色 ， 市场 份额 也 少 得 
可 怜 。 不 过 很 快 ， 在 同年 的 10 月， 谷歌 又 发 布 Android 4.0 系统 ， 这 个 版 本 不 再 对 手机 和 平板 
进行 差异 化 区 分 ， 既 可 以 应 用 在 手机 上 ， 也 可 以 应 用 在 平板 上 。2014 年 Google LO 大 会 上 , 谷 
歌 推出 了 号 称 史 上 版 本 改动 最 大 的 Android 5.0 系统 ， 其 中 使 用 ART 运行 环境 替代 了 Dalvik 虚拟 
机 ， 大 大 提升 了 应 用 的 运行 速度 ， 还 提出 了 Material Design 的 概念 来 优化 应 用 的 界面 设计 。 除 此 
之 外 ， 还 推出 了 Android Wear、Android Auto、Android TV 系统 ， 从 而 进军 可 穿戴 设备 、 汽 车 、 
电视 等 全 新 领域 .之 后 Android 的 更 新 速度 更 加 迅速 ,2015 年 Google VO 大 会 上 推出 了 Android 6.0 
系统 ， 加 入 运行 时 权限 功能 ，2016 年 Google VO 大 会 上 推出 了 Android 7.0 系统 ， 加 入 多 窗口 模 
式 功能 ， 这 也 是 目前 最 新 的 Android 系统 版 本 。 


下 表 列 出 了 目前 主要 的 Android 系统 版 本 及 其 详细 信息 。 你 看 到 这 张 表格 时 ， 数 据 可 能 已 经 
发 生 了 变化 ， 查 看 最 新 的 数据 可 以 访问 http://developer.android.google.cn/about/dashboards/。 


版 本 号 系统 代号 API 市 场 占有 率 
2:2 Froyo 8 0.1% 
2.3.3 一 2.3.7 Gingerbread 10 1.5% 
4.0.3 —4.0.4 Ice Cream Sandwich 15 1.3% 
4.1.X 16 5.6% 
4.2.X Jelly Bean 17 7.7% 


4.3 18 2.3% 
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( 续 ) 
版 本 号 系统 代号 API 市 场 占 有 率 
4.4 KitKat 19 27.7% 
5.0 人 21 13.1% 
Lollipop 

5.1 22 21.9% 
6.0 Marshmallow 23 18.7% 
7.0 Nougat 24 0.1% 


从 上 表 中 可 以 看 出 ， 目 前 4.0 以 上 的 系统 已 经 占据 了 超过 98% 的 Android 市 场 份 额 ， 因 此 我 
们 本 书 中 开发 的 程序 也 只 面向 4.0 以 上 的 系统 ，2.x 的 系统 就 不 再 去 兼容 了 。 


1.1.3 Android 应 用 开发 特色 

预告 一 下 ， 你 马上 就 要 开始 真正 的 Android 开发 旅程 了 。 不 过 先 别 急 ， 在 开始 之 前 我 们 再 来 
一 起 看 一 看 ，Android 系统 到 底 提 供 了 哪些 东西 ， 可 供 我 们 开发 出 优秀 的 应 用 程序 。 

1. 四 大 组 件 

Android 系统 四 大 组 件 分 别 是 活动 (Activity )、 服 务 〈Service )、 广 播 接收 舌 ( BroadcastReceiver ) 
和 内 容 提供 器 ( Content Provider )。 其 中 活动 是 所 有 Android 应 用 程序 的 门面 ， 几 是 在 应 用 中 你 看 
得 到 的 东西 ， 都 是 放 在 活动 中 的 。 而 服务 就 比较 低调 了 ， 你 无 法 看 到 它 , 但 它 会 一 直 在 后 台 默 默 
地 运行 ,即使 用 户 退 出 了 应 用 ,服务 仍然 是 可 以 继续 运行 的 。 广 播 接收 器 允许 你 的 应 用 接收 来 自 
各 处 的 广播 消息 ， 比 如 电话 、 短 信 等 ， 当 然 你 的 应 用 同样 也 可 以 向 外 发 出 广播 消息 。 内 容 提供 器 
则 为 应 用 程序 之 间 共 享 数据 提供 了 可 能 ， 比 如 你 想 要 读 取 系统 电话 舌 中 的 联系 人 , 就 需要 通过 内 
容 提 供 央 来 实现 。 

2. 丰富 的 系统 控件 

Android 系统 为 开发 者 提供 了 丰富 的 系统 控件 ， 使 得 我 们 可 以 很 轻松 地 编写 出 漂亮 的 界面 。 
当然 如 果 你 品位 比较 高 ， 不 满足 于 系统 自 带 的 控件 效果 ， 也 完全 可 以 定制 属于 自己 的 控件 。 

3. SQLite 数据 库 

Android 系统 还 自 带 了 这 种 轻 量 级 、 运 算 速 度 极 快 的 租 入 式 关 系 型 数据 库 。 它 不 仅 支 持 标 准 
的 SQL 语法 ， 还 可 以 通过 Android 封装 好 的 API 进行 操作 ， 让 存储 和 读 取 数据 变 得 非常 方便 。 

4. 强大 的 多 媒体 

Android 系统 还 提供 了 丰富 的 多 媒体 服务 ， 如 音乐 、 视 频 、 录 音 、 拍 照 、 曾 铃 ， 等 等 ， 这 一 
切 你 都 可 以 在 程序 中 通过 代码 进行 控制 ， 让 你 的 应 用 变 得 更 加 丰富 多 彩 。 

5. 地 理 位 置 定 位 

移动 设备 和 PC 相 比 起 来 , 地 理 位 置 定 位 功能 应 该 可 以 算是 很 大 的 一 个 亮点 。 现 在 的 Android 
手机 都 内 置 有 GPS , 走 到 哪儿 都 可 以 定位 到 自己 的 位 置 , 发 挥 你 的 想象 就 可 以 做 出 创意 十 足 的 应 
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用 ， 如 果 再 结合 功能 强大 的 地 图 功能 ，LBS 这 一 领域 潜力 无 限 。 

既然 有 Android 这 样 出 色 的 系统 给 我 们 提供 了 这 么 丰富 的 工具 , 你 还 用 担心 做 不 出 优秀 的 应 
用 吗 ? 好 了 ， 纯 理论 的 东西 就 介绍 到 这 里 ， 我 知道 你 已 经 迫不及待 想 要 开始 真正 的 开发 之 旅 了 ， 
那 我 们 就 开始 启程 吧 ! 


1.2 手把手 市 你 搭建 开发 环境 


俗话 说 得 好 ,“ 工 欲 善 其 事 ， 必 先 利 其 咒 ”， 开 着 记事 本 就 想 去 开发 Android 程序 显然 不 是 明 
智之 举 , 选择 一 个 好 的 IDE 可 以 极 大 幅度 地 提高 你 的 开发 效率 , 因此 本 闻 我 就 将 手把手 带 着 你 把 
开发 环境 搭建 起 来 。 


1.2.1 准备 所 需要 的 工具 


我 现在 对 你 了 解 还 并 不 多 ,但 我 希望 你 已 经 是 一 个 颇 有 经 验 的 Java 程序 员 ， 这 样 你 理解 本 

书 的 内 容 时 将 会 轻而易举 ， 因 为 Android 程序 都 是 使 用 Java 语言 编写 的 。 如 果 你 对 Java 只 是 略 

有 了 解 ， 那 阅读 本 书 应 该 会 有 一 点 困难 ， 不 过 一 边 阅 读 一 边 补 充 Java 知识 也 是 可 以 的 。 但 如 果 

你 对 Java 完全 没有 了 解 ， 那 么 我 建议 你 可 以 暂时 将 本 书 放 下 ， 先 买 本 介绍 Java 基础 知识 的 书 学 

上 两 个 星期 ， 把 Java 的 基本 语法 和 特性 都 学 会 了 ， 再 来 继续 阅读 这 本 书 。 

好 了 ， 既 然 你 已 经 阅读 到 这 里 ,说 明 你 已 经 掌握 Java 的 基本 用 法 了 ， 下 面 我 们 就 来 看 一 看 
开发 Android 程序 需要 准备 哪些 工具 。 

口 JDK。JDK 是 Java 语言 的 软件 开发 工具 包 ， 它 包含 了 Java 的 运行 环境 、 工 具 集 合 、 基 础 

类 库 等 内 容 。 需要 注意 的 是 , 本 书 中 的 Android 程序 必须 要 使 用 JDK 8 或 以 上 版 本 才能 进 

行 开 发 。 

口 Android SDK。Android SDK 是 谷歌 提供 的 Android 开发 工具 包 ， 在 开发 Android 程序 时 ， 

我 们 需要 通过 引入 该 工具 包 ， 来 使 用 Android 相关 的 API。 

口 Android Studio。 在 很 早 之 前 ，Android 项 目 都 是 用 Eclipse 来 开发 的 ， 相 信 所 有 Java 开发 
者 都 一 定 会 对 这 个 工具 非常 熟悉 , 它 是 Java 开发 神器 , 安装 ADT 插件 后 就 可 以 用 来 开发 
Android 程序 了 。 而 在 2013 年 的 时 候 ， 谷 歌 推出 了 一 款 官 方 的 IDE 工具 Android Studio ， 

于 不 再 是 以 插件 的 形式 存在 ，Android Studio 在 开发 Android 程序 方面 要 远 比 Eclipse 强 

大 和 方便 得 多 。 不 过 由 于 Android Studio 早期 的 测试 版 本 并 不 是 非常 稳定 ， 所 以 本 书 的 第 

1 版 仍然 选用 Eclipse 来 作为 开发 工具 。 而 如 今 ，Android Studio 已 经 推出 了 2.2 版 本 ， 稳 

定性 完全 不 再 是 问题 ， 普 及 程度 方面 也 远 超 Eclipse， 没 有 比 现在 更 适合 的 时 机 来 换 用 

Android Studio 了 ， 因 此 本 书 中 所 有 的 代码 都 将 在 Android Studio 上 进行 开发 。 


1.2.2 ”搭建 开发 环境 
当然 ， 上述 软件 并 不 需要 你 去 一 个 个 地 下 载 ， 因 为 谷歌 为 了 简化 搭建 开发 环境 的 过 程 , 将 所 
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有 和 需要 用 到 的 工具 都 帮 我 们 集成 好 了 , 到 Android 官网 就 可 以 下 载 最 新 的 开发 工具 , 下载 地 址 是 : 
https://developer.android.google.cn/studio/index.html。 不 过 ，Android 官网 通常 都 需要 科学 上 网 才能 
访问 ， 如 果 你 无 法 访问 的 话 ， 也 可 以 直接 到 我 的 百度 网 盘 去 下 载 ， 下 载 地 址 是 : https://pan.baidu. 
com/s/lnuABMDb。( 注意 网 址 中 是 阿拉 伯 数 字 1， 而 不 是 英文 字母 1。) 

你 下 载 下 来 的 将 是 一 个 安装 包 ， 安 装 的 过 程 也 很 简单 ， 一 直 点 击 Next 就 可 以 了 。 其 中 选择 
安装 组 件 时 建议 全 部 勾 上 ， 如 图 1.2 所 示 。 


Choose Components 
Choose which features of Android Studio you want to install. 


Check the components you want to install and undheck the components you don't want to 
install, Click Next to continue, 


Select components to install: Android Studio 2 oon 
司 AndroidsDK 写 


Android Virtual Device 


Space required: 4.8GB 


图 1.2 选择 安装 组 件 


接 下 来 还 会 让 你 选择 Android Studio 的 安装 地 址 以 及 Android SDK 的 安装 地 址 ， 这 些 根据 你 
自己 电脑 的 实际 情况 选择 就 行 了 ， 不 想 改 动 的 话 就 保持 默认 ， 如 图 1.3 所 示 。 


Install Locations 


Android Studio Installation Location 


The location spedfied must have at least 500MB of free space. 
Click Browse to customize: 


C:\Program Files\Android VAndroid Studio Browse,, 


Android SDK Installation Location 


The location speafied must have at least 3.2GB of free space. 
Click Browse to customize: 


C:WsersWdministratorWppDataVocalWwndroid\sdk Browse... 


Ee ee 


图 1.3 ”选择 安装 地 址 


后 面 就 没什么 需要 注意 的 了 , 全 部 保持 默认 项 , 一 直 点 击 Next 即 可 完成 安装 , 如 图 1.4 所 示 。 
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Completing Android Studio Setup 


Android Studio has been installed on your computer, 


Click Finish to dose Setup. 


加 StartAndroid Studio 


图 1.4 安装 完成 


现在 点 击 Finish 按钮 来 启动 Android Studio， 一 开始 会 让 你 选择 是 否 导 入 之 前 Android Studio 
版 本 的 配置 ， 由 于 这 是 我 们 首次 安装 ， 这 里 选择 不 导入 就 可 以 了 ， 如 图 1.5 所 示 。 


You can import your settings from a previous version of Studio 
OI want to import my settings from a custom Location 
Specify config folder or installation home of the previous version of Studio 


©@ I do not have a previous version of Studio or I do not want to import my settings 


图 1.5 选择 不 导入 配置 


点 击 OK 按钮 会 进入 到 Android Studio 的 配置 界面 ， 如 图 1.6 所 示 。 


Welcome 


Welcome back! This setup wizard will validate your current Android SDK and 


图 1.6 Android Studio 的 配置 界面 


然后 点 击 Next 开始 进行 具体 的 配置 ， 如 图 1.7 所 示 。 
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这 里 我 们 可 以 选择 Android Studio 的 安装 类 型 ， 有 Standard 和 Custom 两 种 。Standard 表示 一 
切 都 使 用 默认 的 配置 ， 比 较 方便 ;，Custom 则 可 以 根据 用 户 的 特殊 需求 进行 自 定义 。 简 单 起 见 ， 
这 里 我 们 就 选择 Standard 类 型 了 ， 继 续 点 击 Next 完成 配置 工作 ， 如 图 1.8 所 示 。 


炙 


yx Install Type | YX Verify Settings 


Choose the type of setup you want for Android Studio: If you want to review or change any of your installation settings click Previous. 


© standard Current Settings: 
Android Studio will be installed with the most common settings and options. Setup Type: 
Recommended for most users. Standard 


O 〇 Custom SDK Fol 
You can customize installation settings and components installed. CNUse 2 istrator\AppData\Local\Android\Sdk 
| 


| Previous | ceneey |) [_ rinisn | 


图 1.7 选择 安装 类 型 图 1.8 完成 Android Studio 配置 


现在 点 击 Finish 按钮 ， 配 置 工作 就 全 部 完成 了 。 人 然后 Android Studio 会 尝试 联网 下 载 一 些 更 
新 ， 等 待 更 新 完成 后 再 点 击 Finish 按钮 就 会 进入 Android Studio 的 欢迎 界面 ， 如 图 1.9 所 示 。 


区 


MA 


Androld Studio 


Version 2.2 


六 Start a new Android Studio project 


DD Open an existing Android Studio project 
量 Check out project from Version Control » 
[4 Import project (Eclipse ADT, Gradle, etc.) 


[¥ Import an Android code sample 


次 Configure ~ Get Help ~ 


图 1.9 Android Studio 的 欢迎 界面 


目前 为 止 ，Android 开发 环境 就 已 经 全 部 搭建 完成 了 。 那 现在 应 该 做 什么 ”当然 是 写 下 你 的 
第 一 行 Android 代码 了 ， 让 我 们 快 点 开始 吧 。 
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1.3 创建 你 的 第 一 个 Android 项 目 


任何 一 个 编程 语言 写 出 的 第 一 个 程序 毫 无 疑问 都 会 是 Hello World， 这 已 经 是 自 20 世纪 70 
年 代 一 直流 传 下 来 的 传统 ， 在 编程 界 已 成 为 永恒 的 经 由， 那 我 们 当然 也 不 会 搞 例外 了 。 


1.3.1 创建 HelloWorld 项 目 


在 Android Studio 的 欢迎 界面 点 击 Start a new Android Studio project， 会 打开 一 个 创建 新 项 目 
的 界面 ， 如 图 1.10 所 示 。 


| New Project 


/以 Android Studio 


Configure your new project 


Application name: | HelloWorld 


Company Domain: | example.com 


Package name: com.example.helloworld 


OO Include C++ Support 


Project location: | C\Users\Administrator\AndroidStudioprojects\HelloWorld 


图 1.10 创建 新 项 目 


其 中 Application name 表示 应 用 名 称 ， 此 应 用 安装 到 手机 之 后 会 在 手机 上 显示 该 名 称 ， 这 里 
我 们 填 人 HelloWorld。Company Domain 表示 公司 域名 ， 如 果 是 个 人 开发 者 ,没有 公司 域名 的 话 ， 
那么 就 像 我 一 样 填 example.com 就 可 以 了 。Package name 表示 项 目的 包 名 ，Android 系统 就 是 通 
过 包 名 来 区 分 不 同 应 用 程序 的 ， 因 此 包 名 一 定 要 具有 唯一 性 。Android Studio 会 根据 应 用 名 称 和 
公司 域名 来 自动 帮 有 我 们 生成 合适 的 包 名 ， 如 果 你 不 想 使 用 默认 生成 的 包 名 ， 也 可 以 点 击 右 侧 的 
Edit 按钮 自行 修改 。 最 后 ，Project location 表示 项 目 代码 存放 的 位 置 ， 如 果 没 有 特殊 要 求 的 话 ， 
这 里 也 保持 默认 就 可 以 了 。 

接 下 来 点 击 Next 可 以 对 项 目的 最 低 兼容 版 本 进行 设置 ， 如 图 1.11 所 示 。 


| 
yx Target Android Devices 


Select the form factors your app will run on 


Different platforms may require separate SDKs 


Phone and Tablet 


Minimum SDK [API 15: Android 4.0.3 (ceCreamSandwich 


Lower API levels target mo but have fewer features available. 

By targeting API15 and lat pp will run on approximately 98.3% of the devices 
that are active on the Google play Store. 

Help me choose Stats load failed. Value may be out of date, 


口 Wear 


Minimum SDK | API 21: Android 5.0 (Lolipop) 
Dw 


Minimum SDK Ai 21: Android 5.0 (Lollipop) 
口 Android Auto 


口 Glass (Not Available) 


Minimum SDK 


[ER WE FE [去 


图 1.11 设置 项 目的 最 低 兼容 版 本 


前 面 已 经 说 过 ，Android 4.0 以 上 的 系统 已 经 占据 了 超过 98% 的 Android 市 场 份额 ， 因 此 这 里 
我 们 将 Minimum SDK 指定 成 API 15 就 可 以 了 。 男 外 ，Wear、TV 和 Android Auto 这 几 个 选项 分 
别 是 用 于 开发 可 穿戴 设备 、 电 视 和 汽车 程序 的 ， 目 前 这 几 个 领域 在 国内 还 没有 普及 , 我 们 暂时 就 
先 忽 略 吧 。 接 着 点 击 Next 会 跳 转 到 创建 活动 界面 , 这 里 我 们 可 以 选择 一 种 模板 ,如 图 1.12 所 示 。 


create New pra 一 


xx Add an Activity to Mobile 


Add No Activity 


Basic Activity Empty Activity 


Fullscreen Activity Google AdMob Ads Activity Google Maps Activity 


= 
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图 1.12 ”选择 模板 
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可 以 看 到 ，Android Studio 提供 了 很 多 种 内 置 模板 ， 不 过 由 于 我 们 才刚 刚 开 始 学 习 ， 用 不 着 
这 么 多 复杂 的 模板 ， 这 里 直接 选择 Empty Activity 来 创建 一 个 空 的 活动 就 可 以 了 。 


继续 点 击 Next， 可 以 给 创建 的 活动 和 布局 命名 ， 如 图 1.13 所 示 。 


yx Customize the Activity 


Activity Name: | HelloWorldActivity 


Generate Layout File 


Layout Name: | hello_world layout 


Backwards Compatibility (AppCompat) 


The name of the layout to create for the activity 


[ewes) L "ex ] Eee TE 


1.13 ”给 活动 和 布局 命名 
其 中 ，Activity Name 表示 活动 的 名 字 ， 这 里 填 和 人 HelloWorldActivity，Layout Name 表示 布局 
的 命名 ， 这 里 填 入 hello_world layout。 然 后 点 击 Finish 按钮 ， 并 耐心 等 待 一 会 儿 , 项 目 就 会 创建 
成 功 了 ， 如 图 1.14 所 示 。 


Fle Edit View Navigate Code Analyze Refactor Build Run Tools VCS Window Help 
户 司 芳和 放 尖 团团 办 人 中 入 攻 sppzj 状 心肝 站 国内 于 忆 长 了 Q 
3Helloworld D3app Dsre Dmain Djava 四 com example helloworld ccwoiaacvi 
莹 Android "|@ 未 | 类- ”| 加 helloworld layoutxml x | © HelloworldActivityjava x 


3 


package con example helloworld 


alpu9 


5 HelloWorldActivity extends AppCompatActivity { 


. savedInstanceState) { 


上 (© Gradle Scripts 


站 2 Favorites 


Or Buidvarants 
Ppom ploipuy 如 


国 Terminal 混 &AndroidMonitor 国 0:Messages 外 TODO 局 EventLog 国 Gradle Console 
国 Gradle build finished in 26s 325ms (18 minutes ago) 141 CRLF。 UTF-8$ Context <no context> ”了 名 


图 1.14 项 目 创建 成 功 
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第 
1.3.2 ”启动 模拟 器 


由 于 Android Studio 自动 为 我 们 生成 了 很 多 东西 ， 你 现在 不 需要 编写 任何 代码 ，HelloWorld 
项 目 就 已 经 可 以 运行 了 。 但 是 在 此 之 前 还 必须 要 有 一 个 运行 的 载体 ， 可 以 是 一 部 Android 手 机 ， 
也 可 以 是 Android 模 拟 器 。 这 里 我 们 暂时 先 使 用 模拟 器 来 运行 程序 ， 如 果 你 想 立 刻 就 将 程序 运行 
到 手机 上 的 话 ， 可 以 参考 8.1 节 的 内 容 。 

那么 我 们 现在 就 来 创建 一 个 Android 模拟 器 ， 观 察 Android Studio 顶部 工具 栏 中 的 图 标 ， 如 
图 1.15 所 示 。 


图 1.15 顶部 工具 栏 中 的 图 标 


其 中 ， 最 左边 的 按钮 就 是 用 于 创建 和 启动 模拟 器 的 ， 点 击 该 按钮 ， 会 弹出 如 图 1.16 所 示 的 
窗口 。 


Your Virtual Devices 


A Android Studio 


Virtual devices allow you to test your application without 
having to own the physical devices. 


十 Create Virtual Device... 


To prioritize which devices to test your application on, visit 
the Android Dashboards, where you can get up-to-date 

information on which devices are active in the Android and 
Google Play ecosystem. 


图 1.16 创建 模拟 需 


可 以 看 到 , 目前 我 们 的 模拟 器 列表 中 还 是 空 的 , 点 击 Create Virtual Device 按钮 就 可 以 立刻 开 
始 创建 了 ， 如 图 1.17 所 示 。 
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Android Studio 


/以 


GW) Select Hardware 


区 梧 ] 


G- 
1 € 2 [DD Nexus 5X 
川 Category | Name Size | _ Resolution Density | 
TV NexusS 40" 480x800 hdpi 
上 1080px 
Nexus One 3.7" 480x800 hdpi Seem 
ize: a large 
| 
Ratio: long 
| Nexus 6P 57 1440x2560 560dpi Density. 420dpi 
| 
| Nexus 6 5.96" 1440x2560 560dpi 
Nexus 5 4.95" 1080x1920 xxhdpi 
Nexus 4 47" 768x1280 xhdpi 
Galaxy Nexus 4.65" 720x1280 xhdpi 


New Hardware Profile | | Import Hardware Profiles 


[Previous | sere] | rs ] 区 sse 


图 1.17 选择 要 创建 的 模拟 器 设备 


这 里 有 很 多 种 设备 可 供 
模拟 器 。 


我们 选择 ， 不 仅 能 创建 手机 模拟 器 ,还 可 以 创建 平板 、 手 表 、 电 视 等 


那么 我 就 选择 创建 Nexus 5X 这 台 设 备 的 模拟 器 了 ， 点 击 Next， 如 图 1.18 所 示 。 


System Ima 


Android Studio 


Pat 


Select a system image 


Release Name 


两 Virual Device Configuraton 本 


Recommended | xe6 Images | Other Images | 


| APlLevel™ | ABI 全 


区 梧 ] 


-hy 


ge 


API Level 


24 


Android 
0 7.0 
hh 
I [DY 
Google Inc. 
System Image 
x86 


These images are recommended because they run 
the fastest and include support for Google APIs 


Questions on API level? 


i See the API level distribution chart 


[Brevious | | Cancel | [ Frish | [ Help 


图 1.18 ”选择 模拟 器 的 操作 系统 版 本 


这 里 可 以 选择 模拟 顺 所 使 用 的 操作 系统 版 本 , 毫 无 疑问 , 我 们 肯定 要 选择 最 新 的 Android 7.0 


系统 。 继 续 点 击 Next， 如 图 1.19 所 示 。 


证 
二 Vinval Device Conf guton 


2 


AVale [folte BMV/ DIA NAD)) 


A Android Studio 


[i | 


Verify Configuration 
| |AVD Name | Nexus 5x ApI24 | AvD Ware 
| 
加 Nems sx 5.2 1080x1920 420dpi Change... 


The name of this AVD. 


有 Nougat Android 7.0 x86 Change... 
Startup orientation 品 


Portrait Landscape 


Emulated 3 omic 加 
ee Graphics: | Automatic 


Device Frame Enable Device Frame 


Show Advanced Settings 


[previous | | Next | [ cancel | EE | tier 


图 1.19 ”确认 模拟 器 配置 


在 这 里 我 们 可 以 对 模拟 器 的 一 些 配置 进行 确认 ， 比 如 说 指定 模拟 器 的 名 字 、 分 辨 率 、 模 竖 
等 信息 ， 如 果 没 有 特殊 需求 的 话 ， 全 部 保持 默认 就 可 以 了 。 点 击 Finish 完成 模拟 顺 的 创建 ， 然 


会 弹出 如 图 1.20 所 示 的 窗口 。 


Android Virt 


合 WYour Virtual Devices 


/以 Android studio 
| 


Type | Name |Resolution API | 
[DO Nexu.. 1080.. 24 


Target | CPU/ABI | Size on .| 


Andr... 650 ... 


x86 


十 Create Virtual Device... 


1.20 ”模拟 器 列表 


Fz 


后 
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可 以 看 到 ， 现 在 模拟 器 列表 中 已 经 存在 一 个 创建 好 的 模拟 器 设备 了 ， 点 击 Actions 栏目 中 最 
左边 的 三 角形 按钮 即 可 启动 模拟 器 。 模 拟 需 会 像 手 机 一 样 ， 有 一 个 开机 过 程 ， 启 动 完成 之 后 的 界 
面 如 图 1.21 所 示 。 


图 1.21 启动 后 的 模拟 需 界 面 


很 清新 的 Android 界面 出 来 了 ! 看 上 去 还 挺 不 错 吧 ， 你 几乎 可 以 像 使 用 手机 一 样 使 用 它 ， 
Android 模拟 器 对 手机 的 模仿 度 非 常 高 ， 快 去 体验 一 下 吧 。 


1.3.3 ”运行 HelloWorld 


现在 模拟 器 已 经 启动 起 来 了 , 那么 下 面 我 们 就 开始 将 HelloWorld 项 目 运行 到 模拟 器 上 。 观察 
Android Studio 顶部 工具 栏 中 的 图 标 ， 如 图 1.22 所 示 。 其 中 左边 的 锤子 按钮 是 用 来 编译 项 目的 ， 
中 间 的 下 拉 列 表 是 用 来 选择 运行 哪 一 个 项 目的 , 通常 app 就 是 当前 的 主 项 目 , 右边 的 三 角形 按钮 
是 用 来 运行 项 目的 。 


和 [Eapp7) > 
图 1.22 顶部 工具 栏 中 的 图 标 
现在 点 击 右边 的 运行 按钮 ， 会 弹出 一 个 选择 运行 设备 的 对 话 框 ， 如 图 1.23 所 示 。 
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下 n 
网 select Deployment Target [ez 


Connected Devices 


Nexus 5X API 24 (Android 7.0, API 24) 


| create New Virtual Device 


口 Use same selection for future launches | ok | | cancel | 


Iml 


图 1.23 ”选择 运行 设备 对 话 相 
可 以 看 到 ,我们 刚刚 创建 的 模拟 器 现在 是 在 线 的 ,点 击 OK 按钮 ,稍微 等 待 一 会 儿 ,HelloWorld 
项 目 就 会 运行 到 模拟 器 上 了 ， 结 果 应 该 和 图 1.24 中 显示 的 是 一 样 的 。 


HelloWorld 项 目 运行 成 功 ! 并 且 你 会 发 现 , 模拟 右上 已 经 安装 上 HelloWorld 这 个 应 用 了 。 打 
开启 动 需 列表 ， 如 图 1.25 所 示 。 


HelloWorld 


| [©] 口 
图 1.24 运行 HelloWorld 项目 图 1.25 查看 启动 髓 列表 
这 个 时 候 你 可 能 会 说 我 坑 你 了 , 说 好 的 第 一 行 代 码 呢 ?” 怎 么 一 行 还 没 写 , 项 目 就 已 经 运行 起 
来 了 ?这 个 只 能 说 是 因为 Android Studio 太 智 能 了 ,已 经 帮 我 们 把 一 些 简单 内 容 都 自动 生成 了 。 
你 也 别 心急 ， 后面 写 代码 的 机 会 多 着 呢 ， 我 们 先 来 分 析 一 下 HelloWorld 这 个 项 目 吧 。 


1.3.4 分析 你 的 第 一 个 Android 程序 
回 到 Android Studio 当中 ， 首 先 展开 HelloWorld 项 目 ， 你 会 看 到 如 图 1.26 所 示 的 项 目 结构 。 
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声 Android "| 鲜 直 | 次- I 


> 已 app 
p> DD manifests 
> Djava 
p Cares 
T (© Gradle Scripts 
他 build.gradle (Project: HelloWorld) 
© build.gradle (Module: app) 
[i gradle-wrapper.properties (Gradle Version) 


or app) 


目 proguard-rules.pro (ProGuard Rule 
[2 gradle.properties (Project Properties) 


(© settings.gradle (Project Settings) 


[i local.properties (SDK Location) 


图 1.26 ”Android 模式 的 项 目 结构 


任何 一 个 新 建 的 项 目 都 会 默认 使 用 Android 模式 的 项 目 结构 ， 但 这 并 不 是 项 目 真 实 的 目录 结 
构 ， 而 是 被 Android Studio 转换 过 的 。 这 种 项 目 结 构 简 洁 明 了 , 适合 进行 快速 开发 , 但 是 对 于 新 手 
来 说 可 能 并 不 易于 理解 。 点击 图 1.26 当中 的 Android 区 域 可 以 切换 项 目 结构 模式 , 如 图 1.27 所 示 。 


境 ' Android ~ 


Packages 


Scratches 
Android 
Project Files 
Problems 
Production 
Tests 


Tests 


Android Instrumentation Tests 


图 1.27 切换 项 目 结构 模式 


这 里 我 们 将 项 目 结构 模式 切换 成 Project， 这 就 是 项 目 真 实 的 目录 结构 了 ， 如 图 1.28 所 示 。 


ET project ”| 日 丰 | 将- I" 


Vv 


Cz HelloWorld Ci\Users\Administrator\AndroidStud 
pb .gradle 

户 ,idea 

四 app 

户 build 

户 gradle 

目 .gitignore 

3 build.gradle 

[i gradle.properties 
目 gradlew 

目 gradlew.bat 

对 Helloworld,iml 
[i local.properties 


Vv vv 


(SD settings.gradle 


图 1.28 ”Project 模 式 的 项 目 结 构 


一 开始 看 到 这 么 多 陌生 的 东西 ， 你 一 定 会 感到 有 点 头 尝 吧 。 别 担心 ， 我 现在 就 对 图 1.28 中 
的 内 容 进 行 一 一 讲解 ， 之 后 你 再 看 这 张 图 就 不 会 感到 那么 吃力 了 。 
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1. .gradle 和 .idea 

这 两 个 目录 下 放置 的 都 是 Android Studio 自动 生成 的 一 些 文件 ， 我 们 无 须 关 心 ， 也 不 要 去 手 
动 编辑 。 

2. app 

项 目 中 的 代码 、 资 源 等 内 容 几 乎 都 是 放置 在 这 个 目录 下 的 , 我 们 后 面 的 开发 工作 也 基本 都 是 
在 这 个 目录 下 进行 的 ， 待 会 儿 还 会 对 这 个 目录 单独 展开 进行 讲解 。 


3. build 
这 个 目录 你 也 不 需要 过 多 关心 ， 它 主要 包含 了 一 些 在 编译 时 自动 生成 的 文件 。 
4. gradle 


这 个 目录 下 包含 了 gradle wrapper 的 配置 文件 ,使 用 gradle wrapper 的 方式 不 需要 提前 将 gradle 
下 载 好 , 而 是 会 自动 根据 本 地 的 缓存 情况 决定 是 否 需 要 联网 下 载 gradle。Android Studio 默认 没有 
启用 gradle wrapper 的 方式 ,如 果 需 要 打开 ,可 以 点 击 Android Studio 导航 栏 一 File 一 Settings 一 Build， 
Execution, Deployment>Gradle， 进 行 配 置 更 改 。 


5. .gitignore 

这 个 文件 是 用 来 将 指定 的 目录 或 文件 排除 在 版 本 控制 之 外 的 , 关于 版 本 控制 我 们 将 在 第 5 章 
中 开始 正式 的 学 习 。 

6. build.gradle 

这 是 项 目 全 局 的 gradle 构建 脚本 , 通常 这 个 文件 中 的 内 容 是 不 需要 修改 的 。 稍 后 我 们 将 会 详 
细 分 析 gradle 构建 脚本 中 的 具体 内 容 。 

7. gradle.properties 

这 个 文件 是 全 局 的 gradle 配置 文件 , 在 这 里 配置 的 属性 将 会 影响 到 项 目 中 所 有 的 gradle 编译 
脚本 。 

8. gradlew 和 gradlew.bat 

这 两 个 文件 是 用 来 在 命令 行 界面 中 执行 gradle 命令 的 ， 其 中 gradlew 是 在 Linux 或 Mac 系统 
中 使 用 的 ，gradlew.bat 是 在 Windows 系统 中 使 用 的 。 

9. HelloWorld.iml 

iml 文件 是 所 有 IntelliJ IDEA 项 目 都 会 自动 生成 的 一 个 文件 ( Android Studio 是 基于 IntelliJ 
IDEA 开发 的 )， 用 于 标识 这 是 一 个 ntelliJ IDEA 项 目 ， 我 们 不 需要 修改 这 个 文件 中 的 任何 内 容 。 

10. local.properties 

这 个 文件 用 于 指定 本 机 中 的 Android SDK 路 径 ,通常 内 容 都 是 自动 生成 的 ,我 们 并 不 需要 修改 。 
除非 你 本 机 中 的 Android SDK 位 置 发 生 了 变化 ,那么 就 将 这 个 文件 中 的 路 径 改 成 新 的 位 置 即 可 。 
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11. settings.gradle 


这 个 文件 用 于 指定 项 目 中 所 有 引入 的 模块 。 由 于 HelloWorld 项 目 中 就 只 有 一 个 app 模块 ， 
此 该 文件 中 也 就 只 引入 了 app 这 一 个 模块 。 通常 情况 下 模块 的 引入 都 是 自动 完成 的 , 需要 我 们 手 
动 去 修改 这 个 文件 的 场景 可 能 比较 少 。 

现在 整个 项 目的 外 层 目录 结构 已 经 介绍 完了 。 你 会 发 现 , 除了 app 目录 之 外 , 大 多 数 的 文件 
和 目录 都 是 自动 生成 的 ， 我 们 并 不 需要 进行 修改 。 想 必 你 已 经 猜 到 了 ，app 目录 下 的 内 容 才 是 我 
们 以 后 的 工作 重点 ， 展 开 之 后 结构 如 图 1.29 所 示 。 


加 app 
户 build 
口 libs 
户 src 
DD androidTest 
户 main 
户 java 
res 
四 AndroidManifestxml 
Dtest 
目 .gitignore 
[3 appiiml 
5 build.gradle 
目 proguard-rules.pro 


图 1.29 app 目录 下 的 结构 

那么 下 面 我 们 就 来 对 app 目录 下 的 内 容 进 行 更 为 详细 的 分 析 。 

1. build 

这 个 目录 和 外 层 的 build 目录 类 似 ， 主 要 也 是 包含 了 一 些 在 编译 时 自动 生成 的 文件 ， 不 过 它 
里 面 的 内 容 会 更 多 更 杂 ， 我 们 不 需要 过 多 关心 。 

2. libs 

如 果 你 的 项 目 中 使 用 到 了 第 三 方 jar 包 , 就 需要 把 这 些 jar 包 都 放 在 libs 目录 下 ， 放 在 这 个 目 
录 下 的 jar 包 都 会 被 自动 添加 到 构建 路 径 里 去 。 

3. androidTest 

此 处 是 用 来 编写 Android Test 测试 用例 的 ， 可 以 对 项 目 进 行 一 些 自动 化 测试 。 

4. java 

毫 无 疑问 ,java 目录 是 放置 我 们 所 有 Java 代码 的 地 方 , 展开 该 目录 , 你 将 看 到 我 们 刚才 创建 
的 HelloWorldActivity 文件 就 在 里 面 。 

5. res 

这 个 目录 下 的 内 容 就 有 点 多 了 。 简 单 点 说 ， 就 是 你 在 项 目 中 使 用 到 的 所 有 图 片 、 布 局 、 字 符 
串 等 资源 都 要 存放 在 这 个 目录 下 。 当 然 这 个 目录 下 还 有 很 多 子 目 录 ， 图 片 放 在 drawable 目录 下 ， 布 
局 放 在 layout 目录 下 ， 字 符 串 放 在 values 目录 下 ， 所 以 你 不 用 担心 会 把 整个 res 目录 弄 得 乱糟糟 的 。 
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6. AndroidManifest.xml 

这 是 你 整个 Android 项 目的 配置 文件 ,你 在 程序 中 定义 的 所 有 四 大 组 件 都 需要 在 这 个 文件 里 
注册 ,另外 还 可 以 在 这 个 文件 中 给 应 用 程序 添加 权限 声明 。 由 于 这 个 文件 以 后 会 经 常用 到 ,我们 
用 到 的 时 候 再 做 详细 说 明 。 

7.test 

此 处 是 用 来 编写 Unit Test 测试 用 例 的， 是 对 项 目 进行 自动 化 测试 的 另 一 种 方式 。 

8. .gitignore 

这 个 文件 用 于 将 app 模块 内 的 指定 的 目录 或 文件 排除 在 版 本 控制 之 外 ， 作 用 和 外 层 
的 .gitignore 文件 类 似 。 

9. app.iml 

IntelliJ IDEA 项 目 自动 生成 的 文件 ， 我 们 不 需要 关心 或 修改 这 个 文件 中 的 内 容 。 

10. build.gradle 

这 是 app 模块 的 gradle 构建 脚本 ， 这 个 文件 中 会 指定 很 多 项 目 构 建 相 关 的 配置 ， 我 们 稍 后 将 
会 详细 分 析 gradle 构建 脚本 中 的 具体 内 容 。 

11. proguard-rules.pro 

这 个 文件 用 于 指定 项 目 代码 的 混淆 规则 ,当代 码 开 发 完成 后 打 成 安装 包 文件 ,如 果 不 希 望 代 
码 被 别人 破解 ， 通 常会 将 代码 进行 混淆 ， 从 而 让 破解 者 难以 阅读 。 

这 样 整个 项 目的 目录 结构 就 都 介绍 完了 , 如 果 你 还 不 能 完全 理解 的 话 也 很 正常 , 毕竟 里 面 有 
太 多 的 东西 你 都 还 没 接触 过 。 不 过 不 用 担心 , 这 并 不 会 影响 到 你 后 面 的 学 习 。 等 你 学 完整 本 书 再 
回来 看 这 个 目录 结构 图 时 ， 你 会 觉得 特别 地 清晰 和 简单 。 

接 下 来 我 们 一 起 分 析 一 下 HelloWorld 项 目 究竟 是 怎么 运行 起 来 的 吧 。 首 先 打 开 Android- 
Manifest.xml 文件 ， 从 中 可 以 找到 如 下 代码 : 


<activity android:name=" ,HeLLoworLdActivity"> 
<intent-filter> 
<action android:name="android,.intent.action.MAIN" /> 
<category android:name="android.intent.category.LAUNCHER" /> 
</intent-filter> 
</activity> 
这 上段 代码 表示 对 HelloWorldActivity 这 个 活动 进行 注册 ,没有 在 AndroidManifest.xml 里 注册 
的 活动 是 不 能 使 用 的 。 其 中 intent-filter 里 的 两 行 代码 非常 重要 ，<action android:name= 
"android.intent.action.MAIN" /> 和 <category android:name="android.intent.category. 
LAUNCHER" /> 表示 HelloWorldActivity 是 这 个 项 目的 主 活动 ， 在 手机 上 点 击 应 用 图 标 ， 首 先 启动 
的 就 是 这 个 活动 。 


那 HelloWorldActivity 具体 又 有 什么 作用 呢 ? 我 在 介绍 Android 四 大 组 件 的 时 候 说 过 ,活动 
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是 Android 应 用 程序 的 门面 , 凡是 在 应 用 中 你 看 得 到 的 东西 , 都 是 放 在 活动 中 的 。 因 此 你 在 图 1.24 


中 看 到 的 界面 ， 其 实 就 是 HelloWorldActivity 这 个 活动 。 那 我 们 快 去 看 一 下 它 的 代码 吧 ， 打 开 
HelloWorldActivity， 代 码 如 下 所 示 : 


public class HelloWorldActivity extends AppCompatActivity { 


@Override 

protected void onCreate(Bundle savedInstanceState) { 
super.onCreate(savedInstanceState); 
setContentView(R.layout.hello world layout); 


} 


首先 我 们 可 以 看 到 ，HelloWorldActivity 是 继承 自 AppCompatActivity 的 ， 这 是 一 种 向 下 兼容 


的 Activity， 可 以 将 Activity 在 各 个 系统 版 本 中 增加 的 特性 和 功能 最 低 兼容 到 Android 2.1 系统 。 


Activity 是 Android 系统 提供 的 一 个 活动 基 类 ， 我 们 项 目 中 所 有 的 活动 都 必须 继承 它 或 者 它 的 子 
类 才能 拥有 活动 的 特性 ( AppCompatActivity 是 Activity 的 子 类 )。 然 后 可 以 看 到 
HelloWorldActivity 中 有 一 个 onCreate () 方 法 ,这 个 方法 是 一 个 活动 被 创建 时 必定 要 执行 的 方法 ， 
其 中 只 有 两 行 代码 ， 并 且 没 有 Hello World! 的 字样 。 那 么 图 1.24 中 显示 的 Hello World! 是 在 哪里 


定义 的 呢 ? 


其 实 Android 程序 的 设计 讲究 逻辑 和 视图 分 离 ， 因 此 是 不 推荐 在 活动 中 直接 编写 界面 的 ， 更 
加 通用 的 一 种 做 法 是 ,在 布局 文件 中 编写 界面 ,然后 在 活动 中 引入 进来 ,可 以 看 到 ,在 onCreate() 


方法 的 第 二 行 调用 了 setContentView() 方 法 ,就 是 这 个 方法 给 当前 的 活动 引入 了 一 个 


hello_world_layout 布局 , 那 Hello World! 一 定 就 是 在 这 里 定义 的 了 ! 我 们 快 打开 这 个 文件 看 一 看 。 
布局 文件 都 是 


定义 在 res/layout 目录 下 的 ， 当 你 展开 layout 目录 ， 你 会 看 到 hello_world_ 


layout.xml 这 个 文件 。 打 开 该 文件 并 切换 到 Text 视 图 ， 代 码 如 下 所 示 : 


<RelativeLayout xmlns:android="http://schemas.android.com/apk/res/android" 
xmlns:tools="http://schemas.android.com/tools" 


android: 
android: 
android: 
android: 
android: 
android: 
android: 


id="@+id/hello world layout" 

layout width="match parent" 

layout height="match parent" 
paddingBottom="@dimen/activity vertical margin" 
paddingLeft="@dimen/activity horizontal margin" 
paddingRight="@dimen/activity horizontal margin" 
paddingTop="@dimen/activity vertical margin" 


tools:context="com.example.helloworld.HelloWworldActivity"> 


<TextView 
android:layout width="wrap_ content" 
android:layout height="wrap content" 
android:text="Hello World!" /> 
</RelativeLayout> 


现在 还 看 不 懂 ? 没关系 , 后 面 我 会 对 布局 进行 详细 讲解 的 , 你 现在 只 需要 看 到 上 面 代码 中 有 
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一 个 TextView， 这 是 Android 系统 提供 的 一 个 控件 ， 用 于 在 布局 中 显示 文字 的 。 然 后 你 终于 在 
TextView 中 看 到 了 Hello World! 的 字样 ! 哈哈 ! 终于 找到 了 ， 原 来 就 是 通过 android: text= 
"HeLtLo Wortld!1" 这 句 代 码 定义 的 。 

这 样 我 们 就 将 HelloWorld 项 目的 目录 结构 以 及 基本 的 执行 过 程 都 分 析 完 了 ， 相 信 你 对 
Android 项 目 已 经 有 了 一 个 初步 的 认识 ， 下 一 小 节 中 我 们 就 来 学 习 一 下 项 目 中 所 包含 的 资源 。 


1.3.5 ”详解 项 目 中 的 资源 


如 果 你 展开 res 目录 看 一 下 ， 其 实 里 面 的 东西 还 是 挺 多 的 ， 很 容易 让 人 看 得 眼花 练 乱 ， 如 图 
1.30 所 示 。 


Cares 
加 drawable 
加 layout 
加 mipmap-hdpi 
加 mipmap-mdpi 
加 mipmap-xhdpi 
加 mipmap-xxhdpi 
思 mipmap-xodhdpi 
加 values 
加 values-w820dp 


图 1.30 res 目录 下 的 结构 


看 到 这 么 多 的 文件 夹 也 不 用 害怕 ,其 实 归纳 一 下 ,res 目录 就 变 得 非常 简单 了 。 所 有 以 drawable 
开头 的 文件 夹 都 是 用 来 放 图 片 的 ， 所 有 以 mipmap 开头 的 文件 夹 都 是 用 来 放 应 用 图 标的 ， 所 有 以 
values 开头 的 文件 夹 都 是 用 来 放 字符 串 、 样 式 、 颜 色 等 配置 的 ，layout 文件 夹 是 用 来 放 布 局 文件 
的 。 怎 么 样 ， 是 不 是 突然 感觉 清晰 了 很 多 ? 

之 所 以 有 这 么 多 mipmap 开头 的 文件 夹 ， 其 实 主要 是 为 了 让 程序 能 够 更 好 地 兼容 各 种 设备 。 
drawable 文件 夹 也 是 相同 的 道理 , 虽然 Android Studio 没有 帮 我 们 自动 生成 ,但 是 我 们 应 该 自己 创 
建 drawable-hdpi、drawable-xhdpi、drawable-xxhdpi 等 文件 夹 。 在 制作 程序 的 时 候 最 好 能 够 给 同 
一 张 图 片 提供 几 个 不 同 分 辨 率 的 版 本 , 分 别 放 在 这 些 文件 夹 下 ,然后 当 程 序 运行 的 时 候 , 会 自动 
根据 当前 运行 设备 分 辩 率 的 高 低 选 择 加 载 哪个 文件 夹 下 的 图 片 。 当 然 这 只 是 理想 情况 ， 更 多 的 时 
候 美 工具 会 提供 给 我 们 一 份 图 片 ， 这 时 你 就 把 所 有 图 片 都 放 在 drawable-xxhdpi 文 件 夹 下 就 好 了 。 

知道 了 res 目录 下 每 个 文件 夹 的 含义 ， 我 们 再 来 看 一 下 如 何 去 使 用 这 些 资源 吧 。 打 开 res/ 
values/strings.xml 文件 ， 内 容 如 下 所 示 : 


<resources> 
<string name="app_name">HelloWorld</string> 
</resources> 


可 以 看 到 ， 这 里 定义 了 一 个 应 用 程序 名 的 字符 串 ， 我 们 有 以 下 两 种 方式 来 引用 它 。 
口 在 代码 中 通过 R.string.app_name 可 以 获得 该 字符 串 的 引用 。 
口 在 XML 中 通过 @string/app_name 可 以 获得 该 字符 串 的 引用 。 


直 
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基本 的 语法 就 是 上 面 这 两 种 方式 ， 其 中 string 部 分 是 可 以 替换 的 ， 如 果 是 引用 的 图 片 资源 
就 可 以 替换 成 drawable, 如 果 是 引用 的 应 用 图 标 就 可 以 替换 成 mipmap, 如 果 是 引用 的 布局 文件 
就 可 以 替换 成 Layout ， 以 此 类 推 。 


下 面 举 一 个 简单 的 例子 来 帮助 你 理解 ， 打 开 AndroidManifest.xml 文件 ， 找 到 如 下 代码 : 


<application 
android:allowBackup="true" 
android:icon="@mipmap/ic launcher" 
android:label="@string/app_name" 
android:supportsRtl="true" 
android:theme="@style/AppTheme"> 


</application> 

其 中 ,HelloWorld 项 目的 应 用 图 标 就 是 通过 android:icon 属性 来 指定 的 , 应 用 的 名 称 则 是 
通过 android:tLabet 属性 指定 的 。 可 以 看 到 ,这 里 对 资源 引用 的 方式 正 是 我 们 刚刚 学 过 的 在 XML 
中 引用 资源 的 语法 。 

经 过 本 小 节 的 学 习 ， 如 果 你 想 修 改 应 用 的 图 标 或 者 名 称 ， 相 信 已 经 知道 该 怎么 办 了 吧 。 


1.3.6 详解 build.gradle 文件 


不 同 于 Eclipse，Android Studio 是 采用 Gradle 来 构建 项 目的 。Gradle 是 一 个 非常 先进 的 项 目 
构建 工具 ， 它 使 用 了 一 种 基于 Groovy 的 领域 特定 语言 (DSL ) 来 声明 项 目 设置 ， 据 弃 了 传统 基 
于 XML (如 Ant 和 Maven ) 的 各 种 烦琐 配置 。 

在 1.3.4 小 节 中 我 们 已 经 看 到 ，HelloWorld 项 目 中 有 两 个 build.gradle 文件 ， 一 个 是 在 最 外 层 
目录 下 的 ， 一 个 是 在 app 目录 下 的 。 这 两 个 文件 对 构建 Android Studio 项 目 都 起 到 了 至 关 重 要 的 
作用 ， 下 面 我 们 就 来 对 这 两 个 文件 中 的 内 容 进行 详细 的 分 析 。 

先 来 看 一 下 最 外 层 目录 下 的 build.gradle 文件 ， 代 码 如 下 所 示 : 


buildscript { 
repositories { 
jcenter() 


dependencies { 
classpath 'com.android.tools.build:gradle:2.2.0' 
} 
} 


allprojects { 


repositories { 
jcenter() 


} 


这 些 代 码 都 是 自动 生成 的 , 虽然 语法 结构 看 上 去 可 能 有 点 难以 理解 , 但 是 如 果 我 们 忽略 语法 
结构 ， 只 看 最 关键 的 部 分 ， 其 实 还 是 很 好 懂 的 。 
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首先 ， 两 处 repositories 的 闭 包 中 都 声明 了 jcenter() 这 行 配 置 ， 那 么 这 个 jcenter 是 什 
么 意思 呢 ? 其 实 它 是 一 个 代码 托管 仓库 ， 很 多 Android 开源 项 目 都 会 选择 将 代码 托管 到 jcenter 
上 ， 声 明了 这 行 配置 之 后 ， 我 们 就 可 以 在 项 目 中 轻松 引用 任何 jcenter 上 的 开源 项 目 了 。 

接 下 来 ，dependencies 闭 包 中 使 用 cLasspath 声明 了 一 个 Gradle 插件 。 为 什么 要 声明 这 
个 插件 呢 ? 因为 Gradle 并 不 是 专门 为 构建 Android 项 目 而 开发 的 ，Java、C++ 等 很 多 种 项 目 都 可 
以 使 用 Gradle 来 构建 ,因此 如 果 我 们 要 想 使 用 它 来 构建 Android 项 目 , 则 需要 声明 com.android. 
tools.build:gradle:2.2.0 这 个 插件 。 其 中 ， 最 后 面 的 部 分 是 插件 的 版 本 号 ， 我 在 写作 本 书 


时 最 新 的 插件 版 本 是 2.2.0。 


这 样 我 们 就 将 最 外 层 目 录 下 的 build.gradle 文件 分 析 完 了 ， 通 常情 况 下 你 并 不 需要 修改 这 个 


文件 中 的 内 容 ， 除 非 你 想 添 加 一 些 全 局 的 项 目 构 建 配 置 。 
下 面 我 们 再 来 看 一 下 app 目录 下 的 build.gradle 文件 ， 代 码 如 下 所 示 : 


apply plugin: "com.android,appLication' 


android { 

compileSdkVersion 24 

buildToolsVersion "24.0.2" 

defaultConfig { 
applicationId "com.example.helloworld" 
minSdkVersion 15 
targetSdkVersion 24 
versionCode 1 
versionName "1.0" 


} 
buildTypes { 
release { 
minifyEnabled false 


proguardFiles getDefaultProguardFile('proguard-android.txt'), 


"proguard- ruLes.pro' 


} 


dependencies { 
compile fileTree(dir: 'libs', include: ['*,.jar']) 
compile 'com.android,.support:appcompat-v7:24.2.1" 
testCompile ‘junit:junit:4.12'" 

} 


这 个 文件 中 的 内 容 就 要 相对 复杂 一 些 了 , 下 面 我 们 一 行 行 地 进行 分 析 。 首 先 第 一 


行 应 用 了 一 


个 插件 ， 一般 有 两 种 值 可 选 ，com.android.application 表示 这 是 一 个 应 用 程序 模块 ， 
com.android.Library 表示 这 是 一 个 库 模块 。 应 用 程序 模块 和 库 模 块 的 最 大 区 别 在 于 ， 一 个 是 


可 以 直接 运行 的 ， 一 个 只 能 作为 代码 库 依 附 于 别 的 应 用 程序 模块 来 运行 。 
接 下 来 是 一 个 大 的 android 闭 包 ， 在 这 个 闭 包 中 我 们 可 以 配置 项 目 构建 的 各 种 


= 


丘 


刷 性 。 其 中 ， 


compileSdkVersion 用 于 指定 项 目的 编译 版 本 ,这 里 指定 成 24 表示 使 用 Android 7.0 系统 的 SDK 


编译 。buildToolsVersion 用 于 指定 项 目 构建 工具 的 版 本 ， 目 前 最 新 的 版 本 就 是 24.0.2， 如 果 
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有 更 新 的 版 本 时 ，Android Studio 会 进行 提示 。 

然后 我 们 看 到 ， 这 里 在 android 闭 包 中 又 和 藤 套 了 一 个 defaultConfig 闭 包 ，defaultConfig 闭 包 
中 可 以 对 项 目的 更 多 细节 进行 配置 。 其 中 ，applicationId 用 于 指定 项 目的 包 名 ， 前 面 我 们 在 
创建 项 目的 时 候 其 实 已 经 指定 过 包 名 了 ,如 果 你 想 在 后 面 对 其 进行 修改 ,那么 就 是 在 这 里 修改 的 。 
minSdkVersion 用 于 指定 项 目 最 低 兼 容 的 Android 系统 版 本 ， 这 里 指定 成 15 表示 最 低 兼 容 到 
Android 4.0 系统 。targetSsdkVersion 指定 的 值 表 示 你 在 该 目标 版 本 上 已 经 做 过 了 充分 的 测试 ， 
系统 将 会 为 你 的 应 用 程序 启用 一 些 最 新 的 功能 和 特性 。 比 如 说 Android 6.0 系统 中 引入 了 运行 时 
权限 这 个 功能 ， 如 果 你 将 targetSdkVersion 指定 成 23 或 者 更 高 ， 那么 系统 就 会 为 你 的 程序 启 
用 运行 时 权限 功能 ， 而 如 果 你 将 targetSdkVersion 指定 成 22， 那 么 就 说 明 你 的 程序 最 高 只 在 
Android 5.1 系统 上 做 过 充分 的 测试 ， Android 6.0 系统 中 引入 的 新 功能 自然 就 不 会 启用 了 。 剩 下 的 
两 个 属性 都 比较 简单 ，versionCode 用 于 指定 项 目的 版 本 号 ，versionName 用 于 指定 项 目的 版 
本 名 ， 这 两 个 属性 在 生成 安装 文件 的 时 候 非 常 重 要 ， 我 们 在 后 面 都 会 学 到 。 

分 析 完 了 defaultConfig 闭 包 , 接 下 来 我 们 看 一 下 buildTypes 闭 包 。buildTypes 闭 包 中 用 于 指 
定 生 成 安装 文件 的 相关 配置 ， 通 常 只 会 有 两 个 子 闭 包 , 一 个 是 debug, 一 个 是 release。debug 闭 
包 用 于 指定 生成 测试 版 安装 文件 的 配置 ,release 闭 包 用 于 指定 生成 正式 版 安装 文件 的 配置 。 男 外 ， 
debug 闭 包 是 可 以 忽略 不 写 的 ， 因 此 我 们 看 到 上 面 的 代码 中 就 只 有 一 个 release 闭 包 。 下面 来 看 一 
下 release 闭 包 中 的 具体 内 容 吧 , minifyEnabled 用 于 指定 是 否 对 项 目的 代码 进行 混淆 ，true 表 
示 混 淆 ，false 表示 不 混淆 。proguardFiles 用 于 指定 混淆 时 使 用 的 规则 文件 ， 这 里 指定 了 两 
个 文件 ， 第 一 个 proguard-android.,txt 是 在 Android SDK 目录 下 的 ， 里 面 是 所 有 项 目 通用 的 
混 消 规则， 第 二 个 proguard-rules.pro 是 在 当前 项 目的 根 目 录 下 的 ， 里 面 可 以 编写 当前 项 目 
特有 的 混淆 规则 。 需要 注意 的 是 , 通过 Android Studio 直接 运行 项 目 生 成 的 都 是 测试 版 安装 文件 ， 
关于 如 何 生 成 正式 版 安装 文件 我 们 将 会 在 第 15 章 中 学 习 。 

这 样 整个 android 闭 包 中 的 内 容 就 都 分 析 完 了 ， 接 下 来 还 剩 一 个 dependencies 闭 包 。 这 个 闭 
包 的 功能 非常 强大 , 它 可 以 指定 当前 项 目 所 有 的 依赖 关系 。 通 常 Android Studio 项 目 一 共有 3 种 依 
赖 方式 : 本 地 依赖 、 库 依赖 和 远程 依赖 。 本 地 依赖 可 以 对 本 地 的 Jar 包 或 目录 添加 依赖 关系 ， 库 依 
赖 可 以 对 项 目 中 的 库 模 块 添加 依赖 关系 ， 远 程 依赖 则 可 以 对 jcenter 库 上 的 开源 项 目 添加 依赖 关系 。 
观察 一 下 dependencies 闭 包 中 的 配置 ， 第 一 行 的 compile fileTree 就 是 一 个 本 地 依赖 声明 ， 它 
表示 将 libs 目录 下 所 有 .jar 后 组 的 文件 都 添加 到 项 目的 构建 路 径 当 中 。 而 第 二 行 的 compile 则 是 
远程 依赖 声明 ,com,android.support:appcompat-v7:24.2.1 就 是 一 个 标准 的 远程 依赖 库 格 式 ， 
其 中 com.android. support 是 域名 部 分 ,用 于 和 其 他 公司 的 库 做 区 分 ; appcompat-v7 是 组 名 称 ， 
用 于 和 同一 个 公司 中 不 同 的 库 做 区 分 ; 24.2.1 是 版 本 号 ， 用 于 和 同一 个 库 不 同 的 版 本 做 区 分 。 加 
上 这 人 句 声 明 后 ,Gradle 在 构建 项 目 时 会 首先 检查 一 下 本 地 是 否 已 经 有 这 个 库 的 缓存 ， 如 果 没 有 的 话 
则 会 去 自动 联网 下 载 ， 然 后 再 添加 到 项 目的 构建 路 径 当 中 。 至 于 库 依 赖 声 明 这 里 没有 用 到 ， 它 的 
基本 格式 是 compile project 后 面 加 上 要 依赖 的 库 名 称 ， 比 如 说 有 一 个 库 模块 的 名 字 叫 helper， 
那么 添加 这 个 库 的 依赖 关系 只 需要 加 入 compile project(' :hetper') 这 句 声明 即 可 。 另 外 剩 下 
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的 一 句 testCompile 是 用 于 声明 测试 用 例 库 的 ， 这 个 我 们 暂时 用 不 到 ， 先 忽略 它 就 可 以 了 。 


1.4 前 行 必 备 一 一 掌握 日 志 工具 的 使 用 


通过 上 一 节 的 学 习 ， 你 已 经 成 功 创建 了 你 的 第 一 个 Android 程序 ， 并 且 对 Android 项 目的 目 
录 结 构 和 运行 流程 都 有 了 一 定 的 了 解 。 现 在 本 应 该 是 你 继续 前 行 的 时 候 ， 不 过 我 想 在 这 里 给 你 穿 
播 一 点 内 容 ， 讲 解 一 下 Android 中 日 志 工 具 的 使 用 方法 ， 这 对 你 以 后 的 Android 开发 之 旅 会 有 极 
大 的 帮助 。 


1.4.1 ”使 用 Android 的 日 志 工 具 Log 
Android 中 的 日 志 工 具 类 是 Log ( android.util.Log )， 这 个 类 中 提供 了 如 下 5 个 方法 来 供 我 们 
打印 日 志 。 

D Log.v() 。 用 于 打印 那些 最 为 琐碎 的 、 意 义 最 小 的 日 志 信息 。 对 应 级 别 verbose, 是 Android 

日 志 里 面 级 别 最 低 的 一 种 。 

口 Log.d()。 用 于 打印 一 些 调试 信息 ， 这 些 信 息 对 你 调试 程序 和 分 析 问 题 应 该 是 有 帮助 的 。 

对 应 级 别 debug， 比 verbose 高 一 级 。 

口 Log.i()。 用 于 打印 一 些 比 较 重 要 的 数据 , 这些 数据 应 该 是 你 非常 想 看 到 的 、 可 以 帮 你 分 

析 用 户 行为 数据 。 对 应 级 别 info， 比 debug 高 一 级 。 

口 Log.w()。 用 于 打印 一 些 警 告 信息 ,提示 程序 在 这 个 地 方 可 能 会 有 潜在 的 风险 , 最 好 去 修 

复 一 下 这 些 出 现 警告 的 地 方 。 对 应 级 别 warn， 比 info 高 一 级 。 

口 Log.e() 。 用 于 打印 程序 中 的 错误 信息 ， 比 如 程序 进入 到 了 catch 语句 当中 。 当 有 错误 信 
息 打 印 出 来 的 时 候 , 一 般 都 代表 你 的 程序 出 现 严 重 问题 了 , 必须 尽快 修复 。 对 应 级 别 error， 
比 warn 高 一 级 。 

其 实 很 简单 ， 一 共 就 5 个 方法 ， 当 然 每 个 方法 还 会 有 不 同 的 重 载 , 但 那 对 你 来 说 肯定 不 是 什 

么 难 理解 的 地 方 了 。 我 们 现在 就 在 HelloWorld 项 目 中 试 一 试 日 志 工具 好 不 好 用 吧 。 

打开 HelloWorldActivity， 在 onCreate( ) 方 法 中 添加 一 行 打印 日 志 的 语句 ， 如 下 所 示 : 


protected void onCreate(Bundle savedInstanceState) { 
super.onCreate(savedInstanceState); 
setContentView(R.layout.hello world layout); 
Log.d("HelloWorldActivity", "onCreate execute"); 


} 

Log.d() 方 法 中 传人 了 两 个 参数 : 第 一 个 参数 是 tag， 一般 传人 当前 的 类 名 就 好 ， 主 要 用 于 
对 打印 信息 进行 过 滤 ; 第 二 个 参数 是 msg， 即 想 要 打印 的 具体 的 内 容 。 
现在 可 以 重新 运行 一 下 HelloWorld 这 个 项 目 了 , 点 击 顶 部 工具 栏 上 的 运行 按钮 , 或 者 使 用 快 
捷 键 Shift+F10 ( Mac 系统 是 control + R )， 等 程序 运行 完毕 ， 点 击 Android Studio 底部 工具 栏 的 
Android Monitor， 在 logcat 中 就 可 以 看 到 打印 信息 了 ， 如 图 1.31 所 示 。 
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图 1.31 logcat 中 的 打印 信息 


其 中 ， 你 不 仅 可 以 看 到 打印 日 志 的 内 容 和 tag 名， 就 连 程序 的 包 名 、 打 印 的 时 间 以 及 应 用 程 
序 的 进程 号 都 可 以 看 到 。 

另外 , 不 知道 你 有 没有 注意 到 ， 你 的 第 一 行 代码 已 经 在 不 知 不 觉 中 写 出 来 了 ,我 也 总 算是 
交差 了 。 


1.4.2 ”为 什么 使 用 Log 而 不 使 用 System.out 


我 相信 很 多 的 Java 新 手 都 非常 喜欢 使 用 System.out.printtLn() 方 法 来 打印 日 志 ， 不 知道 
你 是 不 是 也 喜欢 这 么 做 。 不 过 在 真正 的 项 目 开 发 中 , 是 极度 不 建议 使 用 System.out.printtn() 
方法 的 ! 如 果 你 在 公司 的 项 目 中 经 常 使 用 这 个 方法 ， 就 很 有 可 能 要 挨 骂 了 。 


为 什么 System,.out ,printtn() 方 法 会 这 么 遭 大 家 唾弃 呢 ? 经 过 我 仔细 分 析 之 后 ,发现 这 个 
方法 除了 使 用 方便 一 点 之 外 ,其 他 就 一 无 是 处 了 -方便 在 哪儿 呢 ? 在 Eclipse 中 你 只 需要 输入 syso， 
然后 按 下 代码 提示 键 ， 这 个 方法 就 会 自动 出 来 了 ， 相 信 这 也 是 很 多 Java 新 手 对 它 钟情 的 原因 。 
那 缺 点 又 在 哪儿 了 呢 ? 这 个 就 太 多 了 ， 比 如 日 志 打印 不 可 控制 、 打 印 时 间 无 法 确定 、 不 能 添加 过 
滤 需 、 日 志 没 有 级 别 区 分 …… 


听 我 说 了 这 些 , 你 可 能 已 经 不 太 想 用 System,out ,printtLn() 方 法 了 , 那么 Log 就 把 上 面 所 
说 的 缺点 全 部 都 改 好 了 吗 ?” 虽然 谈 不 上 全 部 , 但 我 觉得 Log 已 经 做 得 相当 不 错 了 。 我 现在 就 来 带 
你 看 看 Log 和 logcat 配合 的 强大 之 处 。 

首先 刚才 提 到 的 快捷 输入 ， 在 Android Studio 当中 也 是 有 的 ， 比 如 你 想 打印 一 条 debug 级 别 
的 日 志 , 那么 只 需要 输入 logd， 然 后 按 下 Tab 键 ， 就 会 帮 你 自动 补 全 一 条 完整 的 打印 语句 。 输 入 
logi， 然 后 按 下 Tab 键 ， 会 自动 补 全 一 条 info 级 别 的 打印 日 志 。 输 入 logw， 按 下 Tab 键 , 会 自动 
补 全 一 条 war 级 别 的 打印 日 志 ， 以 此 类 推 。 另 外 , 由 于 Log 的 所 有 打印 方法 都 要 求 传人 一 个 tag 
参数 , 每 次 写 一 遍 显 然 太 过 麻烦 。 这 里 还 有 一 个 小 技巧 ,我 们 在 onCreate( ) 方 法 的 外 面 输入 logt， 
然后 按 下 Tab 键 ， 这 时 就 会 以 当前 的 类 名 作为 值 自 动 生成 一 个 TAG 常量 ， 如 下 所 示 : 


public class HelloWorldActivity extends AppCompatActivity { 


由 


private static final String TAG = "HelloWorldActivity"; 
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除了 快捷 输入 之 外 ，logcat 中 还 能 很 轻松 地 添加 过 滤器 ,你 可 以 在 图 1.32 中 看 到 我 们 目前 所 
有 的 过 滤 需 。 


Show only selected application BZ 


Show only selected application 


Edit Filter Configuration 


图 1.32 logcat 中 的 过 滤器 


目前 只 有 3 个 过 滤器 ，Show only selected application 表示 只 显示 当前 选中 程序 的 日 志 ， 
Firebase 是 谷歌 提供 的 一 个 分 析 工 具 ， 我 们 可 以 不 用 管 它 ，No Filters 相当 于 没有 过 滤器 ， 会 把 
所 有 的 日 志 都 显示 出 来 。 那 可 不 可 以 自 定义 过 滤器 呢 ? 当然 可 以 ， 我 们 现在 就 来 添加 一 个 过 滤 
器 试 试 。 

点 击 图 1.32 中 的 Edit Filter Configuration ， 会 弹出 一 个 过 滤器 配置 界面 。 我 们 给 过 滤 需 起 名 
叫 data， 并 且 让 它 对 名 为 data 的 tag 进行 过 滤 ， 如 图 1.33 所 示 。 


Fr nm 
® Create New Logcat Filter 区 梧 
十 一 Filter Name: data 
Specify one or several filtering parameters: 
Log Iag: Qrdata Regex 
Log Message:  (Q- Regex 
Package Name: (Q- Regex 
PID: 
Log Level: Verbose -| 
LE 
J 


图 1.33 过滤 需 配 置 界面 


点 击 OK， 你 就 会 发 现 你 已 经 多 出 了 一 个 data 过 滤器 。 当 你 点 击 这 个 过 滤 需 的 时 候 ， 你 会 发 
现 刚才 在 onCreate() 方 法 里 打印 的 日 志 没 了 ,这 是 因为 data 这 个 过 滤器 只 会 显示 tag 名 称 为 data 
的 日 志 。 你 可 以 尝试 在 onCreate ( ) 方 法 中 把 打印 日 志 的 语句 改 成 Log.d("data"，"onCreate 
execute") ， 然 后 再 次 运行 程序 ， 你 就 会 在 data 过 滤器 下 看 到 这 行 日 志 

不 知道 你 有 没有 体会 到 使 用 过 滤器 的 好 处 , 可 能 现在 还 没有 吧 。 不 过 | 出 成 百 
上 千 行 日 志 的 时 候 ， 你 就 会 迫切 地 需要 过 滤 关 了。 


看 完了 过 滤器 ， 再 来 看 一 下 logcat 中 的 日 志 级 别 控制 吧 。logcat 中 主要 有 5 个 级 别 ， 分 别 对 
应 着 上 一 节 介 绍 的 $ 个 方法 ， 如 图 1.34 所 示 。 


图 1.34 logcat 中 的 日 志 级 别 
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当前 我 们 选中 的 级 别 是 verbose， 也 就 是 最 低 等 级 。 这 意味 着 不 管 我 们 使 用 哪 一 个 方法 打印 
日 志 ， 这 条 日 志 都 一 定 会 显示 出 来 。 而 如 果 我 们 将 级 别 选 中 为 debug， 这 时 只 有 我 们 使 用 debug 
及 以 上 级 别 方法 打印 的 日 志 才 会 显示 出 来 ， 以 此 类 推 。 你 可 以 做 一 下 试验 ， 当 你 把 logcat 中 的 级 
别 选中 为 info、warn 或 者 error 时 , 我 们 在 onCreate() 方 法 中 打印 的 语句 是 不 会 显示 的 ， 因为 我 
们 打印 日 志 时 使 用 的 是 Log.d() 方 法 。 

日 志 级 别 控制 的 好 处 就 是 , 你 可 以 很 快 地 找到 你 所 关心 的 那些 日 志 。 相 信 如 果 让 你 从 上 千 行 
日 志 中 查找 一 条 骨 省 信息 ， 你 一 定 会 抓 狂 的 吧 。 而 现在 你 只 需要 将 日 志 级 别 选中 为 error， 那 些 
不 相干 的 琐碎 信息 就 不 会 再 干扰 你 的 视线 了 。 

最 后 我 们 再 来 看 一 下 关键 字 过 滤 。 如 果 使 用 过 滤器 加 日 志 级 别 控制 还 是 不 能 锁定 到 你 想 查 看 
的 日 志 内 容 的 话 ， 那 么 还 可 以 通过 关键 字 进 行进 一 步 的 过 滤 ， 如 图 1.35 所 示 。 

Qorceate © regex 


图 1.35 ”关键 字 输 入 村 


我 们 可 以 在 输入 框 里 输入 关键 字 的 内 容 , 这 样 只 有 符合 关键 字条 件 的 日 志 才 会 显示 出 来 , 从 
而 能 够 快速 定位 到 任何 你 想 查 看 的 日 志 。 另 外 还 有 一 点 需要 注意 , 关键 字 过 滤 是 支持 正则 表达 式 
的 ， 有 了 这 个 特性 ， 我 们 就 可 以 构建 出 更 加 丰富 的 过 滤 条 件 。 

关于 Android 中 日 志 工具 的 使 用 我 就 准备 讲 到 这 里 ，logcat 中 其 他 的 一 些 使 用 技巧 就 要 靠 你 
自己 去 摸索 了 。 今 天 你 已 经 学 到 了 足够 多 的 东西 ， 我 们 来 总 结 和 梳理 一 下 吧 。 


1.5 “小 结 与 点 评 


你 现在 一 定 会 觉得 很 充实 ,甚至 有 点 沾沾自喜 。 确 实 应 该 如 此 ， 因 为 你 已 经 成 为 一 名 真正 的 
Android 开发 者 了 。 通 过 本 章 的 学 习 ， 你 首先 对 Android 系统 有 了 更 加 充足 的 认识 ， 然 后 成 功 将 
Android 开发 环境 搭建 了 起 来 , 接着 创建 了 你 自己 的 第 一 个 Android 项 目 , 并 对 Android 项 目的 目 
录 结 构 和 执行 过 程 有 了 一 定 的 认识 ,在 本 章 的 最 后 还 学 习 了 Android 日 志 工 具 的 使 用 ， 这 难道 还 
不 够 充实 吗 ? 

不 过 你 也 别 太 过 于 满足 ， 相 信 你 很 清楚 ，Android 开发 者 和 出 色 的 Android 开发 者 还 是 有 很 
大 的 区 别 的 ， 你 还 需要 付出 更 多 的 努力 才 行 。 即 使 你 目前 在 Java 领域 已 经 有 了 不 错 的 成 绩 ， 我 
也 希望 在 Android 的 世界 你 可 以 放下 身段 ， 以 一 只 萌 级 小 菜鸟 的 身份 起 飞 ,在 后 面 的 旅途 中 你 会 
不 断 地 成 长 。 

现在 你 可 以 非常 安心 地 休息 一 段 时 间 ， 因 为 今天 你 已 经 做 得 非常 不 错 了 。 储备 好 能 量 , 准备 
进入 到 下 一 章 的 旅程 当中 。 
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通过 上 一 章 的 学 习 ， 你 已 经 成 功 创建 了 你 的 第 一 个 Android 项目 。 不 过 仅仅 满足 于 此 显然 是 
不 够 的 ， 是 时 候 学 点 新 的 东西 了 。 作 为 你 的 导师 ,我 有 义务 帮 你 制定 好 后 面 的 学 习 路 线 ， 那 么 今 
天 我 们 应 该 从 哪儿 入手 呢 ? 现在 你 可 以 想象 一 下 ， 假 如 你 已 经 写 出 了 一 个 非常 优秀 的 应 用 程序 ， 
然后 推荐 给 你 的 第 一 个 用 户 ， 你 会 从 哪里 开始 介绍 呢 ? 毫 无 疑问 ， 当 然 是 从 界面 开始 介绍 了 ! 因 
为 即使 你 的 程序 算法 再 高 效 ， 架 构 再 出 色 , 用户 根 本 不 会 在 乎 这 些 , 他 们 一 开始 只 会 对 看 得 到 的 
东西 感 兴 趣 ， 那 么 我 们 今天 的 主题 自然 也 要 从 看 得 到 的 入 手 了 。 


2.1 活动 是 什么 


活动 (Activity ) 是 最 容易 吸引 用 户 的 地 方 ， 它 是 一 种 可 以 包含 用 户 界面 的 组 件 ， 主 要 用 于 
和 用 户 进 行 交 互 。 一 个 应 用 程序 中 可 以 包含 零 个 或 多 个 活动 , 但 不 包含 任何 活动 的 应 用 程序 很 少 
见 ， 谁 也 不 想 让 自己 的 应 用 永远 无 法 被 用 户 看 到 吧 

其 实在 上 一 章 中 , 你 已 经 和 活动 打 过 交道 了 , 并 且 对 活动 也 有 了 初步 的 认识 。 不 过 上 一 章 我 
们 的 重点 是 创建 你 的 第 一 个 Android 项 目 ， 对 活动 的 介绍 并 不 多 , 在 本 章 中 我 将 对 活动 进行 详细 


的 介绍 。 


2.2 活动 的 基本 用 法 


到 现在 为 止 ， 你 还 没有 手动 创建 过 活动 呢 ， 因 为 上 一 章 中 的 HelloWorldActivity 是 Android 
Studio 帮 我 们 自动 创建 的 。 手动 创建 活动 可 以 加 深 我 们 的 理解 , 因此 现在 是 时 候 应 该 自己 动手 了 。 
由 于 Android Studio 在 一 个 工作 区 间 内 只 允许 打开 一 个 项 目 ， 因 此 首先 你 需要 将 当前 的 项 目 
关闭 ,点 击 导航 栏 File 一 Close Project。 然 后 再 新 建 一 个 Android 项 目 ,项 目 名 可 以 叫 作 ActivityTest， 
包 名 我 们 就 使 用 默认 值 com.example.activitytest。 新 建 项 目的 步骤 你 已 经 在 上 一 章 学 习 过 了 , 不 
过 图 1.12 中 的 那 一 步 需 要 稍 做 修改 ， 我 们 不 再 选择 Empty Activity 这 个 选项 ， 而 是 选择 Add No 
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Activity， 因 为 这 次 我 们 准备 手动 创建 活动 ， 如 图 2.1 所 示 。 


多 


x Add an Activity to Mobile 


Add No Activity 


Google AdMob Ads Activity Master/Detail Flow 


= 可 


Les re) ee WE 


图 2.1 选择 不 添加 活动 
点 击 Finish， 等 待 Gradle 构建 完成 后 ， 项 目 就 创建 成 功 了 。 


2.2.1 手动 创建 活动 


项 目 创建 成 功 后 , 仍然 会 默认 使 用 Android 模式 的 项 目 结构 , 这 里 我 们 手动 改 成 Project 模式 ， 
本 书 中 后 面 的 所 有 项 目 都 要 这 样 修改 ,以 后 就 不 再 获 述 了 。 目前 ActivityTest 项 目 中 虽然 还 是 会 自 
动 生成 很 多 文件 , 但 是 app/src/main/java/com.example.activitytest 目录 应 该 是 空 的 了 , 如 图 2.2 所 示 。 


v CaActivityTest C:\Users\Administrator\AndroidSt 
pb .gradle 
>» Didea 
7 四 app 
>» Dbuild 
Dlibs 
vOsrc 
>» DandroidTest 
Vv Dmain 
v Djava 
© com.example.activitytest 
* Cares 
芍 AndroidManifest.xml 
> Dtest 
目 .gitignore 
[BB appiiml 
(© build.gradle 
目 proguard-rules.pro 


图 2.2 初始 项 目 结构 


现在 右 击 com.example.activitytest 包 一 New 一 Activity 一 Empty Activity, 会 弹出 一 个 创建 活动 
的 对 话 框 ,我 们 将 活动 命名 为 FirstActivity, 并 且 不 要 勾 选 Generate Layout File 和 Launcher Activity 
这 两 个 选项 ， 如 图 2.3 所 示 。 


32 第 2 章 先 从 看 得 到 的 入 手 一 一 探究 活动 


ET | 


ure Activity 


Creates a new empty activity 


Activity Name: FirstActivity 
a 


DO Launcher Activity 


Backwards Compatibility (AppCompat) 


com exomple.activitytost | "| 


图 2.3 新建 活动 对 话 框 
勾 选 Generate LayoutFile 表示 会 自动 为 FirstActivity 创建 一 个 对 应 的 布局 文件 , 勾 选 Launcher 
Activity 表示 会 自动 将 FirstActivity 设置 为 当前 项 目的 主 活动 ， 这 里 由 于 你 是 第 一 次 手动 创建 活 
动 ， 这 些 自动 生成 的 东西 暂时 都 不 要 勾 选 ， 下 面 我 们 将 会 一 个 个 手动 来 完成 。 勾 选 Backwards 
Compatibility 表示 会 为 项 目 启用 向 下 兼容 的 模式 ， 这 个 选项 要 勾 上 。 点 击 Finish 完成 创建 。 
你 需要 知道 ， 项 目 中 的 任何 活动 都 应 该 重 写 Activity 的 onCreate() 方 法 ， 而 目前 我 们 的 
FirstActivity 中 已 经 重 写 了 这 个 方法 ， 这 是 由 Android Studio 自动 帮 有 我 们 完成 的 ， 代 码 如 下 所 示 ; 


public class FirstActivity extends AppCompatActivity { 


@Override 
protected void onCreate(Bundle savedInstanceState) { 
super.onCreate(savedInstanceState); 


} 


} 
可 以 看 到 ,onCreate() 方 法 非常 简单 ,就 是 调用 了 父 类 的 onCreate() 方 法 。 当 然 这 只 是 默 
认 的 实现 ， 后 面 我 们 还 需要 在 里 面 加 入 很 多 自己 的 逻辑 。 


2.2.2 ”创建 和 加 载 布局 


前 面 我 们 说 过 ，Android 程序 的 设计 讲究 逻辑 和 视图 分 离 ， 最 好 每 一 个 活动 都 能 对 应 一 个 布 
局 ， 布 局 就 是 用 来 显示 界面 内 容 的 ， 因 此 我 们 现在 就 来 手动 创建 一 个 布局 文件 。 

右 击 app/src/main/res 目录 一 New 一 Directory， 会 弹出 一 个 新 建 目录 的 窗口 ， 这 里 先 创建 一 个 
名 为 layout 的 目录 。 然 后 对 着 layout 目录 右键 一 New 一 Layoutresource file， 又 会 弹出 一 个 新 建 布 
局 资源 文件 的 窗口 , 我 们 将 这 个 布局 文件 命名 为 first_ layout, 根 元 素 就 默认 选择 为 LinearLayout， 
如 图 2.4 所 示 。 
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网 New Layout Resource File | 


Ele name: |firstlayout 


Root element: | LinearLayout 


Lo EE 
图 2.4 新建 布 局 资源 文件 
点 击 OK 完成 布局 的 创建 ， 这 时 候 你 会 看 到 如 图 2.5 所 示 的 布局 编辑 器 。 


加 first layoutxml x 


Palette | 浆 - I 因 国 引 全 - ONexus5- E624- (BAppTheme 鸭 Language- Properties 好 | 桨 -中 
Dwidgets 目 因 | 国 国 GOl% 四 加 站 晶 P 


Iayout width match_parent 


二 ToggleButton layout_height match_parent 
国 checkBox 
®) RadioButton 


3Si 


一 ProgressBar (large) |- 日 


View all properties ,二 


Design | Text | 


图 2.5 布局 编辑 器 


这 是 Android Studio 为 我 们 提供 的 可 视 化 布局 编辑 器 ， 你 可 以 在 屏幕 的 中 央 区 域 预览 当前 的 
布局 。 在 窗口 的 最 下 方 有 两 个 切换 卡 , 左边 是 Design, 右边 是 Text。Design 是 当前 的 可 视 化 布局 
编辑 器 ， 在 这 里 你 不 仅 可 以 预览 当前 的 布局 ， 还 可 以 通过 拖 放 的 方式 编辑 布局 。 而 Text 则 是 通 
过 XML 文件 的 方式 来 编辑 布局 的 ， 现 在 点 击 一 下 Text 切换 卡 ， 可 以 看 到 如 下 代码 : 


<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:orientation="vertical" 
android:layout width="match parent" 
android:layout height="match parent"> 


</LinearLayout> 


由 于 我 们 刚才 在 创建 布局 文件 时 选择 了 LinearLayout 作为 根 元 素 , 因此 现在 布局 文件 中 已 经 
有 一 个 LinearLayout 元 素 了 。 那 我 们 现在 对 这 个 布局 稍 做 编辑 ， 添 加 一 个 按钮 ， 如 下 所 示 : 


<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:orientation="vertical" 
android:layout width="match parent" 
android:layout height="match parent"> 


<Button 
android:id="@+id/button 1" 
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android:layout width="match parent" 
android:layout height="wrap content" 
android:text="Button 1" 

/> 


</LinearLayout> 


这 里 添加 了 一 个 Button 元 素 , 并 在 Button 元 素 的 内 部 增加 了 几 个 属性 。android:id 是 给 当 
前 的 元 素 定 义 一 个 唯一 标识 符 ， 之 后 可 以 在 代码 中 对 这 个 元 素 进行 操作 。 你 可 能 会 对 @+id/ 
button_1 这 种 语法 感到 陌生 , 但 如 果 把 加 号 去 掉 ， 变 成 eid/button_1, 这 样 你 就 会 觉得 有 些 熟 
悉 了 吧 ， 这 不 就 是 在 XML 中 引用 资源 的 语法 吗 ? 只 不 过 是 把 string 替换 成 了 id。 是 的 ， 如 果 
你 需要 在 XML 中 引用 一 个 id, 就 使 用 @id/id_name 这 种 语法 ， 而 如 果 你 需要 在 XML 中 定义 一 
个 id， 则 要 使 用 Ge+id/id_name 这 种 语法 。 随 后 android:tLayout_width 指定 了 当前 元 素 的 宽 
度 ， 这 里 使 用 match_parent 表示 让 当前 元 素 和 父 元 素 一 样 宽 。android:tLayout_height 指定 
了 当前 元 素 的 高 度 , 这 里 使 用 wrap_content 表示 当前 元 素 的 高 度 只 要 能 刚好 包含 里 面 的 内 容 就 
行 。android:text 指定 了 元 素 中 显示 的 文字 内 容 。 如 果 你 还 不 能 完全 看 明白 ， 没 有 关系 ， 关 于 
编写 布局 的 详细 内 容 我 会 在 下 一 章 中 重点 讲解 ,本 章 只 是 先 简单 涉及 一 些 。 现 在 按钮 已 经 添加 完 
了 ， 你 可 以 通过 右 侧 工具 栏 的 Preview 来 预览 一 下 当前 布局 ， 如 图 2.6 所 示 。 


Preview 痫 -省 
因 图 明 SS- ONexws5- i624- (BAppTheme 


习 | 图 国 2% 回 四 曙 


图 2.6 预览 当前 布局 
可 以 看 到 , 按钮 已 经 成 功 显示 出 来 了 ,这 样 一 个 简单 的 布局 就 编写 完成 了 。 那 么 接 下 来 我 们 
要 做 的 ， 就 是 在 活动 中 加 载 这 个 布局 。 
重新 加 到 FirstActivity， 在 onCreate() 方 法 中 加 入 如 下 代码 : 


public class FirstActivity extends AppCompatActivity { 


@Override 
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protected void onCreate(Bundle savedInstanceState) { 
super.onCreate(savedInstanceState); 
setContentView(R.Tlayout.first layout); 


} 


可 以 看 到 ， 这 里 调用 了 setContentView() 方 法 来 给 当前 的 活动 加 载 一 个 布局 ， 而 在 
setContentView() 方 法 中 , 我 们 一 般 都 会 传人 一 个 布局 文件 的 id。 在 第 1 章 介绍 项 目 资 源 的 时 
候 我 兽 提 到 过 ， 项 目 中 添加 的 任何 资源 都 会 在 R 文件 中 生成 一 个 相应 的 资源 id， 因 此 我 们 刚才 
创建 的 first_Layout .xml 布局 的 id 现在 应 该 是 已 经 添加 到 及 文件 中 了 。 在 代码 中 去 引用 布局 
文件 的 方法 你 也 已 经 学 过 了 ,只 需要 调用 R.Layout .first_ Layout 就 可 以 得 到 first layout. 
xml 布局 的 id， 然 后 将 这 个 值 传人 setContentView() 方 法 即 可 。 


2.2.3 在 AndroidManifest 文件 中 注册 


别 忘 了 在 上 一 章 我 们 学 过 , 所 有 的 活动 都 要 在 AndroidManifest.xml 中 进行 注册 才能 生效 , 而 
实际 上 FirstActivity 已 经 在 AndroidManifest.xml 中 注册 过 了 ， 我 们 打开 app/src/main/Android- 
Manifestxml 文件 瞧 一 瞧 ， 代 码 如 下 所 示 : 


<manifest xmlns:android="http://schemas.android.com/apk/res/android" 
package="com.example.activitytest"> 
<application 
android:allowBackup="true" 
android:icon="@mipmap/ic launcher" 
android:label="@string/app_name" 
android:supportsRtl="true" 
android:theme="@style/AppTheme"> 
<activity android:name=".FirstActivity"></activity> 
</application> 
</manifest> 
可 以 看 到 ,活动 的 注册 声明 要 放 在 <application> 标 签 内 ， 这 里 是 通过 <activity> 标 签 来 
对 活动 进行 注册 的 。 那 么 又 是 谁 帮 我 们 自动 完成 了 对 FirstActivity 的 注册 呢 ? 当然 是 Android Studio 
了 ,之 前 在 使 用 Eclipse 创建 活动 或 其 他 系统 组 件 时 , 很 多 人 都 会 忘记 要 去 Android Manifest.xml 中 
注册 一 下 ， 从 而 导致 程序 运行 月 泪 ， 很 显然 Android Studio 在 这 方面 做 得 更 加 人 性 化 。 
在 <activity> 标 签 中 我 们 使 用 了 android:name 来 指定 具体 注册 哪 一 个 活动 ， 那 么 这 里 填 入 
的 .FirstActivity 是 什么 意思 呢 ? 其 实 这 不 过 就 是 com ,exampLe .activitytest ,FirstActivity 
的 缩写 而 已 。 由 于 在 最 外 层 的 <manifest> 标 签 中 已 经 通过 package 属性 指定 了 程序 的 包 名 是 
com.examptLe.activitytest， 因 此 在 注册 活动 时 这 一 部 分 就 可 以 省 略 了 ,直接 使 用 .FirstAc- 
tivity 就 足够 了 。 
不 过 , 仅仅 是 这 样 注册 了 活动 , 我 们 的 程序 仍然 是 不 能 运行 的 ， 因 为 还 没有 为 程序 配置 主 活 
动 , 也 就 是 说 ， 当 程序 运行 起 来 的 时 候 ,， 不 知道 要 首先 启动 哪个 活动 。 配 置 主 活动 的 方法 其 实在 
第 1 章 中 已 经 介绍 过 了 ， 就 是 在 <activity> 标 签 的 内 部 加 入 <intent -fitLter> 标 签 ， 并 在 这 个 
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标签 里 添加 <action android:name="android.intent.action.MAIN"/> 和 <category android: 
name="android.intent.category .LAUNCHER" /> 这 两 句 声明 即 可 。 


除 此 之 外 ， 我 们 还 可 以 使 用 android :Labet 指定 活动 中 标题 栏 的 内 容 ， 标 题 栏 是 显示 在 活 
动 最 顶部 的 ， 待 会 儿 运 行 的 时 候 你 就 会 看 到 。 需 要 注意 的 是 ， 给 主 活动 指定 的 label 不 仅 会 成 为 
标题 栏 中 的 内 容 ， 还 会 成 为 启动 器 ( Launcher ) 中 应 用 程序 显示 的 名 称 。 

修改 后 的 AndroidManifest.xml 文件 ， 代 码 如 下 所 示 : 


<manifest xmlns:android="http://schemas.android.com/apk/res/android" 
package="com.example.activitytest"> 
<application 
es 
<activity android:name=".FirstActivity" 
android:LabeL="This is FirstActivity"> 
<intent-filter> 
<action android:name="android.intent.action.MAIN" /> 
<category android:name="android.intent.category .LAUNCHER" /> 
</intent-filter> 
</activity> 
</application> 
</manifest> 


这 样 的 话 ，FirstActivity 就 成 为 我 们 这 个 程序 的 主 活动 了 ， 即 点 击 桌 面 应 用 程序 图 标 时 首先 
打开 的 就 是 这 个 活动 。 另 外 需要 注意 ， 如 果 你 的 应 用 程序 中 没有 声明 任何 一 个 活动 作为 主 活动 ， 
这 个 程序 仍然 是 可 以 正常 安装 的 , 只 是 你 无 法 在 启动 器 中 看 到 或 者 打开 这 个 程序 。 这 种 程序 一 般 
都 是 作为 第 三 方 服务 供 其 他 应 用 在 内 部 进行 调用 的 ， 如 支付 宝 快捷 支付 服务 。 

好 了 ， 现 在 一 切 都 已 准备 就 绪 ， 让 我 们 来 运行 一 下 程序 吧 ， 结 果 如 图 2.7 所 示 。 
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在 界面 的 最 项 部 是 一 个 标题 栏 , 里面 显示 着 我 们 刚才 在 注册 活动 时 指定 的 内 容 。 标 题 栏 的 下 
面 就 是 在 布局 文件 first_layout.xml 中 编写 的 界面 ， 可 以 看 到 我 们 刚刚 定义 的 按钮 。 现 在 你 已 经 
成 功 掌 握 了 手动 创建 活动 的 方法 ， 下 面 让 我 们 继续 看 一 看 你 在 活动 中 还 能 做 哪些 事情 吧 。 


2.2.4 在 活动 中 使 用 Toast 


Toast 是 Android 系统 提供 的 一 种 非常 好 的 提醒 方式 ,在 程序 中 可 以 使 用 它 将 一 些 短小 的 信息 
通知 给 用 户 ， 这 些 信 息 会 在 一 段 时 间 后 自动 消失 , 并 且 不 会 占用 任何 屏幕 空间 ,我 们 现在 就 尝试 
一 下 如 何在 活动 中 使 用 Toast。 


首先 需要 定义 一 个 弹出 Toast 的 触发 点 ， 正 好 界面 上 有 个 按钮 ， 那 我 们 就 让 点 击 这 个 按钮 的 
时 候 弹 出 一 个 Toast 吧 。 在 onCreate() 方 法 中 添加 如 下 代码 : 


protected void onCreate(Bundle savedInstanceState) { 

Super.onCreate(SavedInstanceState ) ; 
SetContentView(R.Layout .first layout); 
Button buttonl = (Button) findViewById(R.id.button 1); 
buttonl.setOnClickListener(new View.0nCLickListener() { 

@Override 

public void onClick(View v) { 

Toast.makeText (FirstActivity.this, "You clicked Button 1", 
Toast .LENGTH_ SHORT) .show() ; 


} 
}); 

} 

在 活动 中 , 可 以 通过 findviewById () 方 法 获取 到 在 布局 文件 中 定义 的 元 素 ， 这 里 我 们 传人 
R.id.button_1, 来 得 到 按钮 的 实例 ， 这 个 值 是 刚才 在 first_layout.xml 中 通过 android:id 属性 
§ 定 的 。 findViewById() 方 法 返回 的 是 一 个 View 对 象 , 我 们 需要 向 下 转型 将 它 转 成 Button 对 
象 。 得 到 按钮 的 实例 之 后 ， 我 们 通过 调用 set0nCLickListener() 方 法 为 按钮 注册 一 个 监听 器 ， 
点 击 按钮 时 就 会 执行 监听 器 中 的 onClick() 方 法 。 因 此 ,弹出 Toast 的 功能 当然 是 要 在 onClick() 
方法 中 编写 了 。 

Toast 的 用 法 非常 简单 ,通过 静态 方法 makeText () 创建 出 一 个 Toast 对 象 ,然后 调用 show() 
将 Toast 显示 出 来 就 可 以 了 。 这 里 需要 注意 的 是 ，makeText() 方 法 需要 传人 3 个 参数 。 第 一 个 参 
数 是 Context， 也 就 是 Toast 要 求 的 上 下 文 ， 由 于 活动 本 身 就 是 一 个 Context 对 象 , 因此 这 里 直 
接 传人 FirstActivity.this 即 可 。 第 二 个 参数 是 Toast 显示 的 文本 内 容 ， 第 三 个 参数 是 Toast 
显示 的 时 长 ， 有 两 个 内 置 常 量 可 以 选择 Toast.LENGTH_SHORT 和 Toast .LENGTH_LONG。 


现在 重新 运行 程序 ， 并 点 击 一 下 按钮 ， 效 果 如 图 2.8 所 示 。 
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5 BB 7:54 
This is FirstActivity 


BUTTON1 


You clicked Button 1 


图 2.8 ”Toast 运行 效果 


2.2.5 ”在 活动 中 使 用 Menu 


手机 毕竟 和 电脑 不 同 , 它 的 屏幕 空间 非常 有 限 ,因此 充分 地 利用 屏幕 空间 在 手机 界面 设计 中 
就 显得 非常 重要 了 。 如 果 你 的 活动 中 有 大 量 的 菜单 需要 显示 ， 这 个 时 候 界 面 设 计 就 会 比较 是 众 ， 
因为 仅 这 些 菜 单 就 可 能 占用 屏幕 将 近 三 分 之 一 的 空间 ， 这 该 怎么 办 呢 ? 不 用 担心 ，Android 给 我 
们 提供 了 一 种 方式 ， 可 以 让 菜单 都 能 得 到 展示 的 同时 ， 还 能 不 占用 任何 屏幕 空间 。 

首先 在 res 目录 下 新 建 一 个 menu 文件 夹 ， 右 击 res 目录 一 New 一 Directory， 输 入 文件 夹 名 
menu， 点 击 OK。 接 着 在 这 个 文件 夹 下 再 新 建 一 个 名 叫 main 的 菜单 文件 ， 右 击 menu 文件 夹 一 
New 一 Menu resource file， 如 图 2.9 所 示 。 


网 New Menu Resource File 


2 Enter a new file name 
上 


main 


| ok | | Cancel | 


图 2.9 新 建 Menu 资源 文件 
文件 名 输入 main， 点 击 OK 完成 创建 。 然 后 在 main.xml 中 添加 如 下 代码 : 


<menu xmlns:android="http://schemas.android.com/apk/res/android"> 
<item 
android:id="@+id/add_item" 
android:title="Add"/> 
<item 
android:id="@+id/remove_ item" 


2.2 ”活动 的 基本 用 法 39 


android:title="Remove"/> 
</menu> 


这 里 我 们 创建 了 两 个 菜单 项 ， 其 中 <item> 标 签 就 是 用 来 创建 具体 的 某 一 个 菜单 项 ， 然 后 通 
过 android:id 给 这 个 菜单 项 指定 一 个 唯一 的 标识 符 ， 通 过 android:title 给 这 个 菜单 项 指定 
一 个 名 称 。 

接着 重新 回 到 FirstActivity 中 来 重 写 onCreate0ptionsMenu() 方 法 , 重 写 方法 可 以 使 用 Ctrl 
+O 快捷 键 ( Mac 系统 是 control + O )， 如 图 2.10 所 示 。 


r y 
出 Select Methods to Override/Implement | 


上 回回 三 


加 bdispatchTrackballEvent(ev'MotionEventj:bool 


b dispatchGenericMotionEvent(ev:MotionEvent) 


H onCreatePanelView(featureld:int):View 
b onprepareOptionsMenu(menu:Menu):boolea! 
b onOptionsltemSelected(item:Menultem):bool 
b onNavigateUp0:boolean 
ba onNavigateUpFromChild(child:Activityj:booles 


@ 
Db dispatchpopulateAccessibiliyEvent(eventAcce 
@ 

) b onCreateNavigateUpTaskStack(builder:TaskS 


DD Copy JavaDoc 


Insert @Override EE ore 
J 


上 


图 2.10 重 写 onCreate0ptionsMenu() 方 法 


上 


然后 在 onCreate0ptionsMenu() 方 法 中 编写 如 下 代码 : 


public boolean onCreate0ptionsMenu(Menu menu) { 

getMenuInflater().inflate(R.menu.main, menu); 

return true; 
} 
通过 getMenuInflater() 方 法 能 够 得 到 MenuInflater 对 象 ， 再 调用 它 的 inflate() 方 法 
就 可 以 给 当前 活动 创建 菜单 了 。inflate() 方 法 接收 两 个 参数 ,第 一 个 参数 用 于 指定 我 们 通过 哪 
一 个 资源 文件 来 创建 菜单 ， 这 里 当然 传人 R.menu.main。 第 二 个 参数 用 于 指定 我 们 的 菜单 项 将 
添加 到 哪 一 个 Menu 对 象 当 中 ,这 里 直接 使 用 onCreate0ptionsMenu( ) 方 法 中 传人 的 menu 参数 。 
然后 给 这 个 方法 返回 true， 表 示人 允许 创建 的 菜单 显示 出 来 ， 如 果 返 回 了 false，, 创建 的 菜单 将 
无 法 显示 。 

当然 ,仅仅 让 菜单 显示 出 来 是 不 够 的 ,我们 定义 菜单 不 仅 是 为 了 看 的 ,关键 是 要 菜单 真正 可 
月 才 行 , 因此 还 要 再 定义 菜单 响应 事件 。 在 FirstActivity 中 重 写 on0ptionsItemSelected() 方 法 : 


public boolean onOptionsItemSelected(MenuItem item) { 
Switch (item.getItemId()) { 
case R.id.add_ item: 
Toast.makeText(this, "You clicked Add", Toast.LENGTH SHORT).show(); 
break; 
case R.id.remove_item: 
Toast.makeText(this, "You clicked Remove", Toast.LENGTH SHORT).show(); 


> 
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break; 
default: 
} 
return true; 


} 


在 on0ptionsItemSelected() 方 法 中 ,通过 调用 item.getItemId() 来 判断 我 们 点 击 的 是 
哪 一 个 菜单 项 ,然后 给 每 个 菜单 项 加 入 自己 的 逻辑 处 理 , 这 里 我 们 就 活 学 活用 ,弹出 一 个 刚刚 学 


会 的 Toast。 


2.11 所 示 。 


可 以 看 到 , 菜单 里 的 菜单 项 默认 是 不 会 显示 出 来 的 ,只 有 点 击 一 下 菜 自 


体 的 内 容 ， 因 此 它 不 会 占用 任何 活动 的 空间 ， 如 图 2.12 所 示 。 
然后 如 果 你 点 击 了 Add 菜单 项 就 会 弹出 You clicked Add 提示 ( 如 图 2.13 所 示 )， 如 果 点 击 了 
Remove 菜单 项 就 会 弹出 You clicked Remove 提示 。 


This is FirstActivity 


BUTTON1 


图 2.11 带 菜单 按钮 的 活动 


2.2.6 ”销毁 一 个 活动 


BUTH Remove 


图 2.12 弹出 菜单 项 的 界面 


按钮 才 会 弹出 里 面具 


重新 运行 程序 ,你 会 发 现在 标题 栏 的 右 侧 多 了 一 个 三 点 的 符号 ,这 个 就 是 菜单 按钮 了 ， 如 图 


This is FirstActivity 


图 2.13 


You clicked Add 


点 击 了 Add 菜单 项 


通过 上 一 节 的 学 习 ， 你 已 经 掌握 了 手动 创建 活动 的 方法 ， 并 学 会 了 如 何在 活动 中 创建 Toast 


和 创建 菜单 。 或 许 你 现在 心中 会 有 个 疑惑 ， 如 何 销毁 一 个 活动 呢 ? 


其 实 答案 非常 简单 ， 只 要 按 一 下 Back 键 就 可 以 销毁 当前 的 活动 了 。 不 过 如 果 你 不 想 通 过 按 


键 的 方式 ,而 是 希望 在 程序 中 通过 代码 来 销毁 活动 ,当然 也 可 以 ,Activity 类 提供 了 一 个 finish() 
方法 ， 我 们 在 活动 中 调用 一 下 这 个 方法 就 可 以 销毁 当前 活动 了 。 
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修改 按钮 监听 器 中 的 代码 ， 如 下 所 示 : 


buttonl.setOnClickListener(new View.OnClickListener() { 
@Override 
public void onClick(View v) { 
finish(); 
} 
}); 
重新 运行 程序 ， 这 时 点 击 一 下 按钮 ， 当 前 的 活动 就 被 成 功 销毁 了 ， 效 果 和 按 下 Back 键 是 一 


样 的 。 
2.3 使 用 Intent 在 活动 之 间 穿 梭 


只 有 一 个 活动 的 应 用 也 大 简单 了 吧 ? 没 错 , 你 的 追求 应 该 更 高 一 点 。 不 管 你 想 创建 多 少 个 活 
动 ,方法 都 和 上 一 节 中 介绍 的 是 一 样 的 。 唯 一 的 问题 在 于 ， 你 在 启动 器 中 点 击 应 用 的 图 标 只 会 进 
入 到 该 应 用 的 主 活动 ,那么 怎样 才能 由 主 活动 跳 转 到 其 他 活动 呢 ? 我 们 现在 就 来 一 起 看 一 看 。 


2.3.1 使 用 显 式 Intent 
你 应 该 已 经 对 创建 活动 的 流程 比较 熟悉 了 ， 那 我 们 现在 快速 地 在 ActivityTest 项 目 中 再 创建 
一 个 活动 。 
仍然 还 是 右 击 com.example.activitytest 包 一 New 一 Activity 一 Empty Activity, 会 弹出 一 个 创建 
活动 的 对 话 框 ， 我 们 这 次 将 活动 命名 为 SecondActivity， 并 勾 选 Generate Layout File， 给 布局 文 
件 起 名 为 second_layout， 但 不 要 勾 选 Launcher Activity 选项 ， 如 图 2.14 所 示 。 


| Configure Activity 
YA Android studio 
Creates a new empty activity 
Activity Name: SecondActivity 
Dore oa fie 
Layout Name: second_layout 


口 Launcher Activity 


Backwards Compatibility (AppCompat) 


| omeromple.activityiest | -| 


Eee De En WE 


图 2.14 创建 SecondActivity 
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点 击 Finish 完成 创建 , Android Studio 会 为 我 们 自动 生成 SecondActivityjava 和 second_ layout. 
xml 这 两 个 文件 。 不 过 自动 生成 的 布局 代码 目前 对 你 来 说 可 能 有 些 复杂 ， 这 里 我 们 仍然 还 是 使 用 最 
熟悉 的 LinearLayout， 编 辑 second_layout.xml， 将 里 面 的 代码 蔡 换 成 如 下 内 容 : 
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:orientation="vertical" 


android:layout width="match parent" 
android:layout height="match parent"> 


<Button 
android:id="@+id/button 2" 
android:layout width="match parent" 
android:layout height="wrap content" 
android:text="Button 2" 
/> 


</LinearLayout> 
我 们 还 是 定义 了 一 个 按钮 ， 按 钮 上 显示 Button 2。 
然后 SecondActivity 中 的 代码 已 经 自动 生成 了 一 部 分 ， 我 们 保持 默认 不 变 就 好 ， 如 下 所 示 : 


public class SecondActivity extends AppCompatActivity { 


@Override 

protected void onCreate(Bundle savedInstanceState) { 
super.onCreate(savedInstanceState);, 
setContentView(R.layout.second layout); 


} 
另外 不 要 忘记 ,任何 一 个 活动 都 是 需要 在 AndroidManifest.xml 中 注册 的 ， 不 过 幸运 的 是 ， 


Android Studio 已 经 帮 有 我 们 自动 完成 了 ， 你 可 以 打开 AndroidManifest.xml 瞧 一 瞧 : 


<appLication 
android:allowBackup="true" 
android:icon="@mipmap/ic launcher" 
android:label="@string/app_name" 
android:supportsRtl="true" 
android:theme="@style/AppTheme"> 
<activity 
android:name=" .FirstActivity" 
android:label="This is FirstActivity"> 
<intent-filter> 
<action android:name="android,.intent.action.MAIN" /> 
<category android:name="android.intent.category.LAUNCHER" /> 
</intent-filter> 
</activity> 
<activity android:name=".SecondActivity"></activity> 
</application> 
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由 于 SecondActivity 不 是 主 活动 ， 因 此 不 需要 配置 <intent-filter> 标 签 里 的 内 容 ,注册 活 
动 的 代码 也 简单 了 许多 。 现在 第 二 个 活动 已 经 创建 完成 , 剩 下 的 问题 就 是 如 何 去 启 动 这 第 二 个 活 
动 了 ， 这 里 我 们 需要 引入 一 个 新 的 概念 : Intent。 

Intent 是 Android 程序 中 各 组 件 之 间 进 行 交 互 的 一 种 重要 方式 ， 它 不 仅 可 以 指明 当前 组 件 想 
要 执行 的 动作 ， 还 可 以 在 不 同 组 件 之 间 传 递 数据 。Intent 一 般 可 被 用 于 启动 活动 、 启 动 服务 以 及 
发 送 广播 等 场景 ， 由 于 服务 、 广 播 等 概念 你 暂时 还 未 涉及 , 那么 本 章 我 们 的 目光 无 疑 就 锁定 在 了 
启动 活动 上 面 。 

Intent 大 致 可 以 分 为 两 种 : 显 式 Intent 和 隐 式 Intent， 我 们 先 来 看 一 下 显 式 Intent 如 何 
使 用 。 


Intent 有 多 个 构造 函数 的 重 载 ， 其 中 一 个 是 Intent(Context packageContext, Class<?> 
cLs) 。 这 个 构造 函数 接收 两 个 参数 ， 第 一 个 参数 Context 要 求 提供 一 个 启动 活动 的 上 下 文 ， 第 
二 个 参数 CLass 则 是 指定 想 要 启动 的 目标 活动 , 通过 这 个 构造 函数 就 可 以 构建 出 Intent 的 “ 意 
图 ”。 然 后 我 们 应 该 怎么 使 用 这 个 Intent 呢 ? Activity 类 中 提供 了 一 个 startActivity() 方 法 , 这 
个 方法 是 专门 用 于 启动 活动 的 ， 它 接收 一 个 Intent 参数 ， 这 里 我 们 将 构建 好 的 Intent 传人 
startActivity() 方 法 就 可 以 启动 目标 活动 了 。 


修改 FirstActivity 中 按钮 的 点 击 事件 ， 代 码 如 下 所 示 : 


buttonl.setOnClickListener(new View.OnClickListener() { 
@Override 
public void onClick(View v) { 
Intent intent = new Intent(FirstActivity.this, SecondActivity.class); 
startActivity(intent); 


ud 


} 
}); 


我 们 首先 构建 出 了 一 个 Intent, 传人 FirstActivity.this 作为 上 下 文 , 传人 Second- 
Activity.ctass 作为 目标 活动 ， 这 样 我 们 的 “意图 ”就 非常 明显 了 ， 即 在 FirstActivity 这 个 活 
动 的 基础 上 打开 SecondActivity 这 个 活动 。 然 后 通过 startActivity() 方 法 来 执行 这 个 Intent。 


重新 运行 程序 ， 在 FirstActivity 的 界面 点 击 一 下 按钮 ， 结 果 如 图 2.15 所 示 。 
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0 中 145 
ActivityTest 


BUTTON 2 


4 oO 0 
图 2.15 ”SecondActivity 界面 
可 以 看 到 ， 我们 已 经 成 功 启动 SecondActivity 这 个 活动 了 。 如 果 你 想 要 回 到 上 一 个 活动 怎么 
办 呢 ? 很 简单 ， 按 下 Back 键 就 可 以 销毁 当前 活动 ， 从 而 回 到 上 一 个 活动 了 。 
使 用 这 种 方式 来 启动 活动 ，Intent 的 “意图 ”非常 明显 ， 因 此 我 们 称 之 为 显 式 Intent。 


2.3.2 ”使 用 隐 式 Intent 


相 比 于 显 式 Intent， 隐 式 Intent 则 含蓄 了 许多 ， 它 并 不 明确 指出 我 们 想 要 启动 哪 一 个 活动 ， 
而 是 指定 了 一 系列 更 为 抽象 的 action 和 category 等 信息 ， 然 后 交 由 系统 去 分 析 这 个 Intent， 
并 帮 我 们 找 出 合适 的 活动 去 启动 。 

什么 叫 作 合适 的 活动 呢 ? 简单 来 说 就 是 可 以 响应 我 们 这 个 隐 式 Intent 的 活动 ， 那 么 目前 
SecondActivity 可 以 响应 什么 样 的 隐 式 Intent 呢 ?” 额 ， 现 在 好 像 还 什么 都 响应 不 了 ， 不 过 很 快 就 
会 有 了 。 

通过 在 <activity> 标 签 下 配置 <intent-fitter> 的 内 容 ， 可 以 指定 当前 活动 能 够 响应 的 
action 和 category， 打 开 AndroidManifest.xml， 添 加 如 下 代码 : 


<activity android:name=".SecondActivity" > 
<intent-filter> 
<action android:name="com.example.activitytest.ACTION START" /> 
<category android:name="android.intent.category.DEFAULT" /> 
</intent-filter> 
</activity> 


在 <action> 标 签 中 我 们 指明 了 当前 活动 可 以 响应 com.examptLe.activitytest.ACTION 
START 这 个 action， 而 <category> 标 签 则 包含 了 一 些 附加 信息 ， 更 精确 地 指明 了 当前 的 活动 能 
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够 响应 的 Intent 中 还 可 能 带 有 的 category。 只 有 <action> 和 <category> 中 的 内 容 同时 能 够 匹配 
上 Intent 中 指定 的 action 和 category 时 ， 这 个 活动 才能 响应 该 Intent。 


修改 FirstActivity 中 按钮 的 点 击 事件 ， 代 码 如 下 所 示 : 


buttonl.setOnClickListener(new View.OnClickListener() { 
@Override 
public void onClick(View v) { 
Intent intent = new Intent("com.example.activitytest.ACTION START"); 
startActivity(intent); 
} 
}); 


可 以 看 到 ， 我 们 使 用 了 Intent 的 男 一 个 构造 函数 ， 直 接 将 action 的 字符 串 传 了 进去 ， 表 明 
我 们 想 要 启动 能 够 响应 com.example.activitytest.ACTION START 这 个 action 的 活动 。 那 
前 面 不 是 说 要 <action> 和 <category> 同 时 匹配 上 才能 响应 的 吗 ? 怎么 没 看 到 哪里 有 指定 
category 呢 ? 这 是 因为 android.intent.category.DEFAULT 是 一 种 默认 的 category， 在 调 


用 startActivity() 方 法 的 时 候 会 自动 将 这 个 category 添加 到 Intent 中 。 


重新 运行 程序 ， 在 FirstActivity 的 界面 点 击 一 下 按钮 ， 你 同样 成 功 启 动 SecondActivity 了 。 
不 同 的 是 ， 这 次 你 是 使 用 了 隐 式 Intent 的 方式 来 启动 的 ， 说 明 我 们 在 <activity> 标 签 下 配置 的 
action 和 category 的 内 容 已 经 生效 了 ! 


每 个 Intent 中 只 能 指定 一 个 action， 但 却 能 指定 多 个 category。 有 目前 我 们 的 Intent 中 只 有 
一 个 默认 的 category， 那 么 现在 再 来 增加 一 个 吧 。 


修改 FirstActivity 中 按钮 的 点 击 事件 ， 代 码 如 下 所 示 : 


buttonl.setOnClickListener(new View.0nCLickListener() { 
@Override 
public void onClick(View v) { 
Intent intent = new Intent("com.example.activitytest.ACTION START"); 
intent.addCategory("com.example.activitytest.MY CATEGORY"); 
startActivity(intent); 


} 
})y 
可 以 调用 Intent 中 的 addCategory() 方 法 来 添加 一 个 category， 这 里 我 们 指定 了 一 个 自 定 
义 的 category， 值 为 com.example.activitytest.MY CATEGORY。 
现在 重新 运行 程序 ， 在 FirstActivity 的 界面 点 击 一 下 按钮 ， 你 会 发 现 ， 程 序 崩 演 了 ! 这 是 你 
第 一 次 遇 到 程序 崩 演 ,可 能 会 有 些 束 手 无 策 。 别 紧张 , 其 实 大 多 数 的 骨 演 问题 都 是 很 好 解决 的 ， 
只 要 你 善于 分 析 。 在 logcat 界面 查看 错误 日 志 ， 你 会 看 到 如 图 2.16 所 示 的 错误 信息 。 


Process: com. example.activitytest, PID: 24027 
android. content.ActivityNotFoundException: No Activity found to handle Intent { 
act=com. example. activitytest. ACTION_START cat=[com. example.activitytest. MY_CATEGORY] } 


图 2.16 错误 信息 
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错误 信息 中 提醒 我 们 ,没有 任何 一 个 活动 可 以 响应 我 们 的 Intent， 为 什么 呢 ? 这 是 因为 我 们 
刚刚 在 Intent 中 新 增 了 一 个 category ,而 SecondActivity 的 <intent-filter> 标 签 中 并 没有 声明 
可 以 响应 这 个 category， 所 以 就 出 现 了 没有 任何 活动 可 以 响应 该 Intent 的 情况 。 现 在 我 们 在 
<intent-filter> 中 再 添加 一 个 category 的 声明 ， 如 下 所 示 : 


<activity android:name=".SecondActivity" > 
<intent-filter> 
<action android:name="com.example.activitytest.ACTION START” /> 
<category android:name="android.intent.category.DEFAULT" /> 
<category android:name="com.example.activitytest.MY CATEGORY"/> 
</intent-filter> 
</activity> 


再 次 重新 运行 程序 ， 你 就 会 发 现 一 切 都 正常 了 。 


2.3.3 更 多 隐 式 Intent 的 用 法 


上 一 节 中 ， 你 掌握 了 通过 隐 式 Intent 来 启动 活动 的 方法 ,但 实际 上 隐 式 Intent 还 有 更 多 的 内 
容 需 要 你 去 了 解 ， 本 节 我 们 就 来 展开 介绍 一 下 。 

使 用 隐 式 Intent， 我 们 不 仅 可 以 启动 自己 程序 内 的 活动 ， 还 可 以 启动 其 他 程序 的 活动 ， 这 使 
得 Android 多 个 应 用 程序 之 间 的 功能 共享 成 为 了 可 能 。 比 如 说 你 的 应 用 程序 中 需要 展示 一 个 网 页 ， 
这 时 你 没有 必要 自己 去 实现 一 个 浏览 器 (事实 上 也 不 太 可 能 )， 而 是 只 需要 调用 系统 的 浏览 器 来 
打开 这 个 网 页 就 行 了 。 

修改 FirstActivity 中 按钮 点 击 事件 的 代码 ， 如 下 所 示 : 


buttonl.setOnClickListener(new View.0nCLickListener() { 
@Override 
public void onClick(View v) { 
Intent intent = new Intent(Intent.ACTION VIEW); 
intent.setData(Uri.parse("http://www.baidu.com")); 
startActivity(intent); 


} 

}); 

这 里 我 们 首先 指定 了 Intent 的 action 是 Intent ,ACTION VIEW， 这 是 一 个 Android 系统 内 
置 的 动作 ， 其 常量 值 为 android.intent.action.VIEW。 然 后 通过 Uri.parse() 方 法 , 将 一 个 
网 址 字符 串 解 析 成 一 个 Uri 对 象 ， 再 调用 Intent 的 setData() 方 法 将 这 个 Uri 对 象 传递 进去 。 

重新 运行 程序 , 在 FirstActivity 界面 点 击 按钮 就 可 以 看 到 打开 了 系统 浏览 器 , 如 图 2.17 所 示 。 

在 上 述 代码 中 , 可 能 你 会 对 setData () 部 分 感觉 到 陌生 , 这 是 我 们 前 面 没有 讲 到 的 。 这 个 方 
法 其 实 并 不 复杂 , 它 接收 一 个 Uri 对 象 ， 主 要 用 于 指定 当前 Intent 正在 操作 的 数据 ， 而 这 些 数据 
通常 都 是 以 字符 串 的 形式 传人 到 Uri.parse() 方 法 中 解析 产生 的 。 
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图 2.17 系统 浏览 器 界面 


与 此 对 应 ， 我 们 还 可 以 在 <intent-filter> 标 签 中 再 配置 一 个 <data> 标 签 ， 用 于 更 精确 地 
指定 当前 活动 能 够 响应 什么 类 型 的 数据 。<data> 标 签 中 主要 可 以 配置 以 下 内 容 。 


Dandroid:scheme。 用 于 指定 数据 的 协议 部 分 ， 如 上 例 中 的 http 部 分 。 
D android:host。 用 于 指定 数据 的 主机 名 部 分 ， 如 上 例 中 的 wwwbaidu.com 部 分 。 
Dandroid:port。 用 于 指定 数据 的 端口 部 分 ， 一 般 紧 随 在 主机 名 之 后 。 
口 android:path。 用 于 指定 主机 名 和 端口 之 后 的 部 分 , 如 一 段 网 址 中 跟 在 域名 之 后 的 内 容 。 
Dandroid:mimeType。 用 于 指定 可 以 处 理 的 数据 类 型 , 允许 使 用 通配符 的 方式 进行 指定 。 
只 有 <data> 标 签 中 指定 的 内 容 和 Intent 中 携带 的 Data 完全 一 致 时 ， 当 前 活动 才能 够 响应 该 
Intent。 不 过 一 般 在 <data> 标 签 中 都 不 会 指定 过 多 的 内 容 ， 如 上 面 浏 览 吕 示例 中 ， 其 实 只 需要 指 
定 android:scheme 为 http， 就 可 以 响应 所 有 的 http 协议 的 Intent 了 。 
为 了 让 你 能 够 更 加 直观 地 理解 , 我 们 来 自己 建立 一 个 活动 , 让 它 也 能 响应 打开 网 页 的 Intent。 
右 击 com.example.activitytest 包 一 New 一 Activity 一 Empty Activity， 新 建 ThirdActivity， 并 人 勾 
选 Generate Layout File， 给 布局 文件 起 名 为 third layout， 点 击 Finish 完成 创建 。 然 后 编辑 
third_layout.xml， 将 里 面 的 代码 替换 成 如 下 内 容 : 
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:orientation="vertical" 


android:layout width="match parent" 
android:layout height="match parent"> 


<Button 
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android:id="@+id/button 3" 
android:layout width="match parent" 
android:layout height="wrap content" 
android:text="Button 3" 

/> 


</LinearLayout> 


ThirdActivity 中 的 代码 保持 不 变 就 可 以 了 ， 最 后 在 AndroidManifest.xml 中 修改 ThirdActivity 
的 注册 信息 : 


<activity android:name=".ThirdActivity"> 
<intent-filter> 
<action android:name="android.intent.action.VIEW" /> 
<category android:name="android.intent.category.DEFAULT" /> 
<data android:scheme="http" /> 
</intent-filter> 
</activity> 


我 们 在 ThirdActivity 的 <intent-filter> 中 配置 了 当前 活动 能 够 响应 的 action 是 Intent , 
ACTION_VIEW 的 常量 值 ， 而 category 则 毫 无 疑问 指定 了 默认 的 category 值 ， 另 外 在 <data> 
标签 中 我 们 通过 android:scheme 指定 了 数据 的 协议 必须 是 http 协议 , 这样 ThirdActivity 应 该 就 
和 浏览 器 一 样 , 能 够 响应 一 个 打开 网 页 的 Intent 了 。 让 我 们 运行 一 下 程序 试 试 吧 , 在 FirstActivity 
的 界面 点 击 一 下 按钮 ， 结 果 如 图 2.18 所 示 。 


Open with 


Browser 


羡  ActivityTest 


图 2.18 选择 响应 Intent 的 程序 
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可 以 看 到 ， 系 统 自动 弹出 了 一 个 列表 ， 显 示 了 目前 能 够 响应 这 个 Intent 的 所 有 程序 。 选 择 
Browser 还 会 像 之 前 一 样 打开 浏览 锅 ， 并 显示 百度 的 主页 ， 而 如 果 选 择 了 ActivityTest， 则 会 启动 
ThirdActivity。 JUST ONCE 表示 只 是 这 次 使 用 选择 的 程序 打开 , ALWAYS 则 表示 以 后 一 直 都 使 用 
这 次 选择 的 程序 打开 。 需 要 注意 的 是 , 虽然 我 们 声明 了 ThirdActivity 是 可 以 响应 打开 网 页 的 Intent 
的 , 但 实际 上 这 个 活动 并 没有 加 载 并 显示 网 页 的 功能 , 所 以 在 真正 的 项 目 中 尽量 不 要 出 现 这 种 有 
可 能 误导 用 户 的 行为 ， 不 然 会 让 用 户 对 我 们 的 应 用 产生 负面 的 印象 。 


除了 http 协议 外 , 我 们 还 可 以 指定 很 多 其 他 协议 ， 比 如 geo 表示 显示 地 理 位 置 、tel 表示 拨打 
电话 。 下 面 的 代码 展示 了 如 何在 我 们 的 程序 中 调用 系统 拨号 界面 。 


buttonl.setOnClickListener(new View.0nCLickListener() { 
@Override 
public void onClick(View v) { 
Intent intent = new Intent(Intent.ACTION DIAL); 
intent.setData(Uri.parse("tel:10086")); 
startActivity(intent); 


} 
}); 


首先 指定 了 Intent 的 action 是 Intent.ACTION DIAL， 这 又 是 一 个 Android 系统 的 内 置 动 
作 。 然 后 在 data 部 分 指定 了 协议 是 tel， 号 码 是 10086。 重 新 运行 一 下 程序 ， 在 FirstActivity 的 界 
面 点 击 一 下 按钮 ， 结 果 如 图 2.19 所 示 。 
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2 Addtoacontact 
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图 2.19 ”系统 拨号 界 押 
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2.3.4 ”向 下 一 个 活动 传递 数据 


经 过 前 面 几 节 的 学 习 ， 你 已 经 对 Intent 有 了 一 定 的 了 解 。 不 过 到 目前 为 止 , 我 们 都 只 是 简单 
地 使 用 Intent 来 启动 一 个 活动 ， 其 实 Intent 还 可 以 在 启动 活动 的 时 候 传递 数据 ， 下 面 我 们 来 一 起 
看 一 下 。 

在 启动 活动 时 传递 数据 的 思路 很 简单 ，Intent 中 提供 了 一 系列 putExtra() 方 法 的 重 载 ， 可 
以 把 我 们 想 要 传递 的 数据 暂 存在 Intent 中 ， 启 动 了 男 一 个 活动 后 ， 只 需要 把 这 些 数据 再 从 Intent 
中 取出 就 可 以 了 。 比 如 说 FirstActivity 中 有 一 个 字符 串 ， 现 在 想 把 这 个 字符 串 传 递 到 Second- 
Activity 中 ， 你 就 可 以 这 样 编写 : 

buttonl.setOnClickListener(new View.0nCLickListener() { 

@Override 
public void onClick(View v) { 
String data = "Hello SecondActivity"; 
Intent intent = new Intent(FirstActivity.this, SecondActivity.class); 


intent.putExtra("extra data", data); 
startActivity(intent); 


} 
}); 


这 里 我 们 还 是 使 用 显 式 Intent 的 方式 来 启动 SecondActivity, 并 通过 putExtra() 方 法 传递 了 
一 个 字符 串 。 注 意 这 里 putExtra() 方 法 接收 两 个 参数 ， 第 一 个 参数 是 键 ， 用 于 后 面 从 Intent 中 
取 值 ， 第 二 个 参数 才 是 真正 要 传递 的 数据 。 

然后 我 们 在 SecondActivity 中 将 传递 的 数据 取出 ， 并 打印 出 来 ， 代 码 如 下 所 示 : 


public class SecondActivity extends AppCompatActivity { 


@Override 

protected void onCreate(Bundle savedInstanceState) { 
super.onCreate(savedInstanceState); 
setContentView(R.layout.second layout); 
Intent intent = getIntent(); 
String data = intent.getStringExtra("extra data"); 
Log.d("SecondActivity", data); 


} 


首先 可 以 通过 getIntent() 方 法 获取 到 用 于 启动 SecondActivity 的 Intent ， 然 后 调用 
getStringExtra() 方 法 , 传人 相应 的 键 值 , 就 可 以 得 到 传递 的 数据 了 。 这 里 由 于 我 们 传递 的 是 
字符 串 ， 所 以 使 用 getStringExtra() 方 法 来 获取 传递 的 数据 。 如 果 传 递 的 是 整 型 数据 ， 则 使 
用 getIntExtra() 方 法 ; 如 果 传 递 的 是 布尔 型 数据 ， 则 使 用 getBooleanExtra() 方 法 ， 以 此 
类 推 。 

重新 运行 程序 ， 在 FirstActivity 的 界面 点 击 一 下 按钮 会 跳 转 到 SecondActivity， 查 看 logcat 
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打印 信息 ， 如 图 2.20 所 示 。 


> ~ 
Debug -| Q- 有 


com. example. activitytest D/SecondActivity: Hello SecondActivity 


图 2.20 SecondActivity 中 的 打印 信息 


可 以 看 到 ， 我们 在 SecondActivity 中 成 功 得 到 了 从 FirstActivity 传递 过 来 的 数据 。 


2.3.5 ”返回 数据 给 上 一 个 活动 


既然 可 以 传递 数据 给 下 一 个 活动 ,那么 能 不 能 够 返回 数据 给 上 一 个 活动 呢 ? 答案 是 肯定 的 。 
不 过 不 同 的 是 ， 返 回 上 一 个 活动 只 需要 按 一 下 Back 键 就 可 以 了 ， 并 没有 一 个 用 于 启动 活动 的 
Intent 来 传递 数据 。 通 过 查阅 文档 你 会 发 现 ，Activity 中 还 有 一 个 startActivityForResult() 
方法 也 是 用 于 启动 活动 的 ， 但 这 个 方法 期 望 在 活动 销毁 的 时 候 能 够 返回 一 个 结果 给 上 一 个 活动 。 
毫 无 疑问 ， 这 就 是 我 们 所 需要 的 。 
startActivityForResult() 方 法 接收 两 个 参数 ， 第 一 个 参数 还 是 Intent， 第 二 个 参数 是 请 
求 码 ， 用 于 在 之 后 的 回调 中 判断 数据 的 来 源 。 我 们 还 是 来 实战 一 下 ， 修 改 FirstActivity 中 按钮 的 
点 击 事件 ， 代 码 如 下 所 示 : 
buttonl.setOnClickListener(new View.0nCLickListener() { 
@Override 
public void onClick(View v) { 


Intent intent = new Intent(FirstActivity.this, SecondActivity.class); 
startActivityForResult(intent, 1); 


} 
}); 


这 里 我 们 使 用 了 startActivityForResult() 方 法 来 启动 ScondActivity， 请 求 码 只 要 是 一 
侍 一 值 就 可 以 了 ， 这 里 传人 了 1。 接 下 来 我 们 在 SecondActivity 中 给 按钮 注册 点 击 事件 ， 并 在 
点 击 事件 中 添加 返回 数据 的 逻辑 ， 代 码 如 下 所 示 : 


public class SecondActivity extends AppCompatActivity { 


个 


ey 


GOverride 
protected void onCreate(Bundle savedInstanceState) { 
super.onCreate(savedInstanceState); 
setContentView(R.layout.second layout); 
Button button2 = (Button) findViewById(R.id.button 2); 
button2.setOnClickListener(new View.0nCLickListener() { 
@Override 
public void onClick(View v) { 
Intent intent = new Intent(); 
intent.putExtra("data _ return", "Hello FirstActivity"); 
setResult(RESULT OK, intent); 
finish(); 
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}); 


} 


可 以 看 到 ,我 们 还 是 构建 了 一 个 Intent， 只 不 过 这 个 Intent 仅仅 是 用 于 传递 数据 而 已 ， 它 没 
有 指定 任何 的 “意图 ”。 紧 接着 把 要 传递 的 数据 存放 在 Intent 中 , 然后 调用 了 setResult() 方 法 。 
这 个 方法 非常 重要 ， 是 专门 用 于 向 上 一 个 活动 返回 数据 的 。setResult() 方 法 接收 两 个 参数 ， 
第 一 个 参数 用 于 向 上 一 个 活动 返回 处 理 结果 ， 一 般 只 使 用 RESULT_O0K 或 RESULT_CANCELED 这 
两 个 值 , 第 二 个 参数 则 把 带 有 数据 的 Intent 传递 回去 , 然后 调用 了 finish() 方 法 来 销毁 当前 活 
动 。 

由 于 我 们 是 使 用 startActivityForResult() 方 法 来 启动 SecondActivity 的 , 在 SecondActivity 
被 销毁 之 后 会 回调 上 一 个 活动 的 onActivityResult() 方 法 ， 因 此 我 们 需要 在 FirstActivity 中 重 
写 这 个 方法 来 得 到 返回 的 数据 ， 如 下 所 示 : 

GOverride 

protected void onActivityResult(int requestCode, int resultCode, Intent data) { 

switch (requestCode) { 
case 1: 
if (resultCode == RESULT OK) { 


String returnedData = data.getStringExtra("data return"); 
Log.d("FirstActivity", returnedData); 


} 
break; 
default: 


} 


onActivityResult() 方 法 带 有 三 个 参数 ， 第 一 个 参数 redquestCode ， 即 我 们 在 启动 活动 时 
传人 的 请 求 码 。 第 二 个 参数 resultCode， 即 我 们 在 返回 数据 时 传 信 的 处 理 结果 。 第 三 个 参数 
data,， 即 携带 着 返回 数据 的 Intent。 由 于 在 一 个 活动 中 有 可 能 调用 startActivityForResult() 
方法 去 启动 很 多 不 同 的 活动 , 每 一 个 活动 返回 的 数据 都 会 回调 到 onActivityResult() 这 个 方法 
中 ， 因 此 我 们 首先 要 做 的 就 是 通过 检查 requestCode 的 值 来 判断 数据 来 源 。 确 定数 据 是 从 
SecondActivity 返回 的 之 后 ,我 们 再 通过 resultCode 的 值 来 判断 处 理 结果 是 否 成 功 , 最 后 从 data 
中 取 值 并 打印 出 来 ， 这 样 就 完成 了 向 上 一 个 活动 返回 数据 的 工作 。 
重新 运行 程序 ,在 FirstActivity 的 界面 点 击 按钮 会 打开 SecondActivity , 然后 在 SecondActivity 
界面 点 击 Button 2 按钮 会 回 到 FirstActivity， 这 时 查看 logcat 的 打印 信息 ， 如 图 2.21 所 示 。 
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[ce 图 G- 


com. example. activitytest D/FirstActivity: Hello FirstActivity 


图 2.21 FirstActivity 中 的 打印 信息 
可 以 看 到 ，SecondActivity 已 经 成 功 返 回 数据 给 FirstActivity 了 。 


这 时 候 你 可 能 会 问 , 如 果 用 户 在 SecondActivity 中 并 不 是 通过 点 击 按钮 ,而 是 通过 按 下 Back 
键 回 到 FirstActivity， 这 样 数据 不 就 没 法 返回 了 吗 ? 没 错 ， 不 过 这 种 情况 还 是 很 好 处 理 的 ， 我 们 
可 以 通过 在 SecondActivity 中 重 写 onBackPressed () 方 法 来 解决 这 个 问题 ， 代 码 如 下 所 示 : 


@Override 
public void onBackPressed() { 
Intent intent = new Intent(); 
intent.putExtra("data return", "Hello FirstActivity"); 
setResult(RESULT OK, intent); 
finish(); 


} 


这 样 的 话 ， 当 用 户 按 下 Back 键 ， 就 会 去 执行 onBackPressed() 方 法 中 的 代码 ,我 们 在 这 里 
添加 返回 数据 的 逻辑 就 行 了 。 


2.4 活动 的 生命 周期 


掌握 活动 的 生命 周期 对 任何 Android 开发 者 来 说 都 非常 重要 ， 当 你 深入 理解 活动 的 生命 周期 
之 后 , 就 可 以 写 出 更 加 连贯 流畅 的 程序 ,并 在 如 何 合理 管理 应 用 资源 方面 发 挥 得 游 力 有 余 。 你 的 


应 用 程序 将 会 拥有 更 好 的 用 户 体验 。 
2.4.1 返回 栈 

经 过 前 面 几 节 的 学 习 ， 我 相信 你 已 经 发 现 了 这 一 点 ，Android 中 的 活动 是 可 以 层 伙 的 。 我 们 
每 启动 一 个 新 的 活动 ， 就 会 覆盖 在 原 活 动 之 上 ， 然 后 点 击 Back 键 会 销毁 最 上 面 的 活动 ， 下 面 的 


一 个 活动 就 会 重新 显示 出 来 。 

其 实 Android 是 使 用 任务 (Task ) 来 管理 活动 的 ， 一 个 任务 就 是 一 组 存放 在 栈 里 的 活动 的 集 
合 ， 这 个 栈 也 被 称 作 返回 栈 ( Back Stack )。 栈 是 一 种 后 进 先 出 的 数据 结构 ， 在 默认 情况 下 ， 每 当 
我 们 启动 了 一 个 新 的 活动 ， 它 会 在 返回 栈 中 人 栈 ， 并 处 于 栈 顶 的 位 置 。 而 每 当 我 们 按 下 Back 键 
或 调用 finish() 方 法 去 销毁 一 个 活动 时 ， 处 于 栈 顶 的 活动 会 出 栈 ， 这 时 前 一 个 人 栈 的 活动 就 会 
重新 处 于 栈 顶 的 位 置 。 系 统 总 是 会 显示 处 于 栈 项 的 活动 给 用 户 。 

示意 图 2.22 展示 了 返回 栈 是 如 何 管理 活动 人 栈 出 栈 操作 的 。 
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启动 一 个 新 活动 
将 栈 顶 活 动 移 除 


2.4.2 ”活动 状态 

每 个 活动 在 其 生命 周期 中 最 多 可 能 会 有 4 种 状态 。 

1. 运行 状态 

当 一 个 活动 位 于 返回 栈 的 栈 顶 时 , 这 时 活动 就 处 于 运行 状态 。 系 统 最 不 愿意 回收 的 就 是 处 于 
运行 状态 的 活动 ， 因 为 这 会 带 来 非常 差 的 用 户 体 验 。 

2. 暂停 状态 

当 一 个 活动 不 再 处 于 栈 顶 位 置 , 但 仍然 可 见 时 ， 这 时 活动 就 进入 了 暂停 状态 。 你 可 能 会 觉得 
既然 活动 已 经 不 在 栈 顶 了 ， 还 怎么 会 可 见 呢 ? 这 是 因为 并 不 是 每 一 个 活动 都 会 占 满 整 个 屏幕 的 ， 
比如 对 话 框 形式 的 活动 只 会 占用 屏幕 中 间 的 部 分 区 域 , 你 很 快 就 会 在 后 面 看 到 这 种 活动 。 处 于 暂 
停 状态 的 活动 仍然 是 完全 存活 着 的 ， 系统 也 不 愿意 去 回收 这 种 活动 ( 因为 它 还 是 可 见 的 ， 回收 可 
见 的 东西 都 会 在 用 户 体验 方面 有 不 好 的 影响 )， 只 有 在 内 存 极 低 的 情况 下 ， 系 统 才 会 去 考虑 回收 
这 种 活动 。 

3. 停止 状态 

当 一 个 活动 不 再 处 于 栈 顶 位 置 ， 并且 完 全 不 可 见 的 时 候 ， 就 进入 了 停止 状态 。 系 统 仍然 会 为 
这 种 活动 保存 相应 的 状态 和 成 员 变 量 , 但 是 这 并 不 是 完全 可 靠 的 ， 当 其 他 地 方 需要 内 存 时 ,处 于 
停止 状态 的 活动 有 可 能 会 被 系统 回收 。 

4. 销毁 状态 

当 一 个 活动 从 返回 栈 中 移 除 后 就 变 成 了 销毁 状态 。 系 统 会 最 倾向 于 回收 处 于 这 种 状态 的 活 
动 ， 从 而 保证 手机 的 内 存 充足 。 
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2.4.3 ”活动 的 生存 期 


Activity 类 中 定义 了 7 个 回调 方法 ,覆盖 了 活动 生命 周期 的 每 一 个 环节 ， 下 面 就 来 一 一 介绍 
这 7 个 方法 。 
口 onCreate()。 这 个 方法 你 已 经 看 到 过 很 多 次 了， 每 个 活动 中 我 们 都 重 写 了 这 个 方法 ， 它 
会 在 活动 第 一 次 被 创建 的 时 候 调 用 。 你 应 该 在 这 个 方法 中 完成 活动 的 初始 化 操作 ， 比 如 
说 加 载 布局 、 绑 定 事 件 等 。 
D onStart()。 这 个 方法 在 活动 由 不 可 见 变 为 可 见 的 时 候 调 用 
口 onResume()。 这 个 方法 在 活动 准备 好 和 用 户 进行 交互 的 时 候 调 用 。 此 时 的 活动 一 定位 于 
返回 栈 的 栈 硕 ， 并 且 处 于 运行 状态 。 
口 onPause( ) 。 这 个 方法 在 系统 准备 去 启动 或 者 恢复 另 一 个 活动 的 时 候 调 用 。 我们 通常 会 在 
这 个 方法 中 将 一 些 消耗 CPU 的 资源 释放 掉 ， 以 及 保存 一 些 关键 数据 ， 但 这 个 方法 的 执行 
速度 一 定 要 快 ， 不 然 会 影响 到 新 的 栈 顶 活动 的 使 用 。 
口 onStop() 。 这 个 方法 在 活动 完全 不 可 见 的 时 候 调 用 。 它 和 onPause( ) 方 法 的 主要 区 别 在 
于 ， 如 果 局 动 的 新 活动 是 一 个 对 话 框 式 的 活动 ,那么 onPause() 方 法 会 得 到 执行 ， 而 
onStop () 方 法 并 不 会 执行 。 


[e] 


邮 口 onDest roy() 。 这 个 方法 在 活动 被 销毁 之 前 调用 ， 之 后 活动 的 状态 将 变 为 销毁 状态 。 
电 口 onRestart() 。 这 个 方法 在 活动 由 停止 状态 变 为 运行 状态 之 前 调用 ， 也 就 是 活动 被 重新 
启动 了 。 
以 上 7 个 方法 中 除了 onRestart () 方 法 ， 其 他 都 是 两 两 相对 的 ， 从 而 又 可 以 将 活动 分 为 3 


口 完整 生存 期 。 活动 在 onCreate() 方 法 和 onDestroy() 方 法 之 间 所 经 历 的 , 就 是 完整 生存 
期 。 一 般 情况 下 ， 一 个 活动 会 在 onCreate() 方 法 中 完成 各 种 初始 化 操作 ， 而 在 
onDestroy() 方 法 中 完成 释放 内 存 的 操作 。 

口 可 见 生存 期 。 活 动 在 onStart() 方 法 和 onStop() 方 法 之 间 所 经 历 的 ， 就 是 可 见 生 存 期 。 
在 可 见 生存 期 内 ,活动 对 于 用 户 总 是 可 见 的 ， 即 便 有 可 能 无 法 和 用 户 进行 交互 。 我 们 可 
以 通过 这 两 个 方法 ,合理 地 管理 那些 对 用 户 可 见 的 资源 。 比 如 在 onStart() 方 法 中 对 资 
源 进行 加 载 ， 而 在 onStop() 方 法 中 对 资源 进行 释放 ， 从 而 保证 处 于 停止 状态 的 活动 不 会 
占用 过 多 内 存 。 

口 前 台 生存 期 。 活 动 在 onResume() 方 法 和 onPause() 方 法 之 间 所 经 历 的 就 是 前 台 生 存 期 。 
在 前 台 生存 期 内 ,活动 总 是 处 于 运行 状态 的 ， 此 时 的 活动 是 可 以 和 用 户 进行 交互 的 ， 我 
们 平时 看 到 和 接触 最 多 的 也 就 是 这 个 状态 下 的 活动 。 

为 了 帮助 你 能 够 更 好 地 理解 ，Android 官方 提供 了 一 张 活动 生命 周期 的 示意 图 ， 如 图 2.23 

所 示 。 
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上 一 个 活动 
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onDestroy() 
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关闭 活动 


图 


2.4.4 体验 活动 的 生命 周期 


活动 的 生 


命 


223 周期 


讲 了 这 么 多 理论 知识 , 也 是 时 候 该 
观 地 体验 活动 的 生命 周期 。 


实战 一 下 了 , 下面 我 们 将 通过 一 个 实例 , 让 你 可 以 更 加 直 


这 次 我 们 不 准备 在 ActivityTest 这 个 项 目的 基础 上 修改 了 ， 而 是 新 建 一 个 项 目 。 因 此 ， 首 先 
关闭 ActivityTest 项 目 ， 点 击 导 航 栏 File 一 Close Project。 然 后 再 新 建 一 个 ActivityLifeCycleTest 


项 目 ， 新建 项 目的 过 程 你 应 该 已 经 非常 清楚 了 ， 不 需要 我 青 进 行 袭 述 ， 这 次 我 们 允许 Android 
Studio 帮 我 们 自动 创建 活动 和 布局 ， 这 样 可 以 省 去 不 少 工 作 ， 创 建 的 活动 名 和 布局 名 都 使 用 默 


认 值 。 


这 样 主 活动 就 创建 完成 了 , 我 们 还 需要 分 别 再 创建 两 个 子 活动 


Activity， 下 面 一 步 步 来 实现 。 


NormalActivity 和 Dialog- 


2.4 活动 的 生命 周期 57 


右 击 com.example.activitylifecycletest 包 一 New 一 Activity 一 Empty Activity ， 新 建 Normal- 
Activity ， 布 局 起 名 为 normal layout。 然 后 使 用 同样 的 方式 创建 DialogActivity ， 布 局 起 名 为 
dialog layout。 


现在 编辑 normal layout.xml 文件 ， 将 里 面 的 代码 替换 成 如 下 内 容 : 


<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:orientation="vertical" 
android:layout width="match parent" 
android:layout height="match parent"> 


<TextView 
android:layout width="match parent" 
android:layout height="wrap content" 
android:text="This is a normal activity" 
/> 


</LinearLayout> 

这 个 布局 中 我 们 就 非常 简单 地 使 用 了 一 个 TextView, 用 于 显示 一 行文 字 , 在 下 一 章 中 你 将 会 
学 到 更 多 关于 TextView 的 用 法 。 

然后 再 编辑 dialog layout.xml 文件 ， 将 里 面 的 代码 蔡 换 成 如 下 内 容 : 


<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:orientation="vertical" 
android:layout width="match parent" 
android:layout height="match parent"> 


<TextView 
android:layout width="match parent" 
android:layout height="wrap content" 
android:text="This is a dialog activity" 
/> 


</LinearLayout> 

两 个 布局 文件 的 代码 几乎 没有 区 别 ， 只 是 显示 的 文字 不 同 而 已 。 

NormalActivity 和 DialogActivity 中 的 代码 我 们 保持 默认 就 好 ， 不 需要 改动 。 

其 实 从 名 字 上 你 就 可 以 看 出 ,这 两 个 活动 一 个 是 普通 的 活动 , 一 个 是 对 话 框 式 的 活动 。 可 是 
我 们 并 没有 修改 活动 的 任何 代码 ,两 个 活动 的 代码 应 该 几乎 是 一 模 一 样 的 , 在 哪里 有 体现 出 将 活 
动 设 成 对 话 框 式 的 呢 ?” 别 着 急 , 下面 我 们 马上 开始 设置 ,修改 AndroidManifest.xml 的 <activity> 
标签 的 配置 ， 如 下 所 示 : 


<activity android:name=".NormalActivity"> 
</activity> 
<activity android:name=" .DialogActivity" 

android: theme="@style/Theme.AppCompat .Dialog"> 
</activity> 
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这 里 是 两 个 活动 的 注册 代码 ,但 是 DialogActivity 的 代码 有 些 不 同 ， 我 们 给 它 使 用 了 一 个 


android:theme 属性 ， 


这 是 用 于 给 当前 活动 指定 主题 的 , Android 系统 内 置 有 很 多 主题 可 以 选择 ， 


当然 我 们 也 可 以 定制 自己 的 主题 ， 而 这 里 @style/Theme.AppCompat.Dialog 则 毫 无 疑问 是 让 
DialogActivity 使 用 对 话 框 式 的 主题 。 
接 下 来 我 们 修改 activity_main.xml, 重新 定制 主 活动 的 布局 , 将 里 面 的 代码 替换 成 如 下 内 容 : 


<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:orientation="vertical" 
android:layout width="match parent" 
android:layout height="match parent"> 


<Button 


android: 
android: 
android: 
android: 


<Button 


android: 
android: 
android: 
android: 


</LinearLayout> 


id="@+id/start normal activity" 
layout width="match parent" 
layout height="wrap_ content" 
text="Start NormalActivity" /> 


id="@+id/start dialog activity" 
layout width="match parent" 
layout height="wrap content" 
text="Start DialogActivity" /> 


可 以 看 到 ， 我 们 在 LinearLayout 中 加 入 了 两 个 按钮 ， 一 个 用 于 启动 NormalActivity ， 一 个 用 


于 启动 DialogActivity。 


最 后 修改 MainActivity 中 的 代码 ， 如 下 所 示 : 


public class MainActivity extends AppCompatActivity { 


public static final String TAG = "MainActivity"; 


@Override 


protected void onCreate(Bundle savedInstanceState) { 
super.onCreate(savedInstanceState); 
Log.d(TAG, "onCreate"); 
setContentView(R.layout.activity main); 
Button startNormalActivity = (Button) findViewById(R.id.start normal _ 


activity); 

Button startDialogActivity = (Button) findViewById(R.id,.start dialog 
activity); 

startNormalActivity.setOnClickListener(new View.0nCLickListener() { 
@Override 


public void onClick(View v) { 


} 
}); 


Intent intent = new Intent (MainActivity.this, NormalActivity.class); 
startActivity(intent); 


startDialogActivity.setOnClickListener(new View.OnClickListener() { 
@Override 
public void onClick(View v) { 
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Intent intent = new Intent (MainActivity.this, DialogActivity.class); 
startActivity(intent); 


}); 
} 


GOverride 

protected void onStart() { 
super.onStart(); 
Log.d(TAG, "onStart"); 

} 


GOverride 

protected void onResume() { 
super.onResume(); 
Log.d(TAG, "onResume"); 

} 


GOverride 

protected void onPause() { 
Super.onPause() ; 
Log.d(TAG, "onPause"); 

} 


@Override 

protected void onStop() { 
super.onStop(); 
Log.d(TAG, "onStop"); 

} 


@Override 

protected void onDestroy() { 
super.onDestroy(); 
Log.d(TAG, "onDestroy"); 

} 


@Override 

protected void onRestart() { 
super.onRestart(); 
Log.d(TAG, "onRestart"); 


} 

在 onCreate() 方 法 中 ， 我 们 分 别 为 两 个 按钮 注册 了 点 击 事 件 ， 点 击 第 一 个 按钮 会 启动 
NormalActivity， 点 击 第 二 个 按钮 会 启动 DialogActivity。 然 后 在 Activity 的 7 个 回调 方法 中 分 别 
打印 了 一 句 话 ， 这 样 就 可 以 通过 观察 日 志 的 方式 来 更 直观 地 理解 活动 的 生命 周期 。 

现在 运行 程序 ， 效 果 如 图 2.24 所 示 。 
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102 
ActivityLifeCycleTest 


START NORMALACTIVITY 


START DIALOGACTIVITY 


图 2.24 MainActivity 界 务 
这 时 观察 logcat 中 的 打印 日 志 ， 如 图 2.25 所 示 。 


| verbose | -| G- » 


com. example. activitylifecycletest D/MainActivity: onCreate 
com. example. activitylifecycletest D/MainActivity: onStart 


com. example. activitylifecycletest D/MainActivity: onResume 


图 2.25 ”启动 程序 时 的 打印 日 志 


可 以 看 到 ， 当 MainActivity 第 一 次 被 创建 时 会 依次 执行 onCreate() 、onStart() 和 
onResume () 方 法 。 然 后 点 击 第 一 个 按钮 ， 启 动 NormalActivity， 如 图 2.26 所 示 。 


1:36 
ActivityLifeCycleTest 


Thi normal actvity 


2.26 ”NormalActivity 界面 
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此 时 的 打印 信息 如 图 2.27 所 示 。 


EE 国人 ) 


com. example. activitylifecycletest D/MainActivity: onPause 


com. example. activitylifecycletest D/MainActivity: onStop 


图 2.27 打开 NormalActivity 时 的 打印 日 志 


由 于 NormalActivity 已 经 把 MainActivity 完全 遮挡 住 ， 因 此 onPause() 和 onStop () 方 法 都 
会 得 到 执行 。 然 后 按 下 Back 键 返回 MainActivity， 打 印信 息 如 图 2.28 所 示 。 


lverbose 加 G- 


com. example. activitylifecycletest D/MainActivity: onRestart 


com. example. activitylifecycletest D/MainActivity: onStart 


com. example. activitylifecycletest D/MainActivity: onResume 


图 2.28 返回 MainActivity 的 打印 日 志 


由 于 之 前 MainActivity 已 经 进入 了 停止 状态 , 所 以 onRestart () 方 法 会 得 到 执行 后 又 会 
依次 执行 onStart() 和 onResume() 方 法 ,注意 此 时 onCreate() 方 法 不 会 执行 ,因为 Re 
并 没有 重新 创建 。 


然后 再 点 击 第 二 个 按钮 ， 启 动 DialogActivity， 如 图 2.29 所 示 。 


ActivityLifeCycleTest 
a dialog actlty 


图 2.29 ”DialogActivity 界面 
此 时 观察 打印 信息 ， 如 图 2.30 所 示 。 


zz 7 


com. example. activitylifecycletest D/MainActivity: onPause 


图 2.30 打开 DialogActivity 时 的 打印 日 志 
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可 以 看 到 ， 只 有 onPause() 方 法 得 到 了 执行 ，onStop() 方 法 并 没有 执行 ， 这 是 因为 
DialogActivity 并 没有 完全 遮挡 住 MainActivity， 此 时 MainActivity 只 是 进入 了 暂停 状态 ， 并 没有 
进入 停止 状态 。 相 应 地 , 按 下 Back 键 返回 MainActivity 也 应 该 具有 onResume( ) 方 法 会 得 到 执行 ， 
如 图 2.31 所 示 。 


二 区 了 


com. example. activitylifecycletest D/MainActivity: onResume 


图 2.31 再 次 返回 MainActivity 的 打印 日 志 
最 后 在 MainActivity 按 下 Back 键 退出 程序 ， 打 印信 息 如 图 2.32 所 示 。 
Verbose 图 @- ) 


com. example. activitylifecycletest D/MainActivity: onPause 


com. example. activitylifecycletest D/MainActivity: onStop 


com. example. activitylifecycletest D/MainActivity: onDestroy 


图 2.32 退出 程序 时 的 打印 日 志 


依次 会 执行 onPause() 、onStop() 和 onDestroy() 方 法 ， 最 终 销 毁 MainActivity。 
这 样 活动 完整 的 生命 周期 你 已 经 体验 了 一 遍 ， 是 不 是 理解 得 更 加 深刻 了 ? 


2.4.5 活动 被 回收 了 怎么 办 


前 面 我 们 已 经 说 过 ， 当 一 个 活动 进入 到 了 停止 状态 , 是 有 可 能 被 系统 回收 的 。 那 么 想象 以 下 
场景 : 应 用 中 有 一 个 活动 A， 用 户 在 活动 A 的 基础 上 启动 了 活动 B, 活动 A 就 进入 了 停止 状态 ， 
这 个 时 候 由 于 系统 内 存 不 足 ， 将 活动 A 回收 掉 了 ， 然 后 用 户 按 下 Back 键 返 回 活动 A， 会 出 现 什 
么 情况 呢 ? 其 实 还 是 会 正常 显示 活动 A 的 ， 只 不 过 这 时 并 不 会 执行 onRestart( ) 方 法 ， 而 是 会 
执行 活动 A 的 onCreate() 方 法 ， 因 为 活动 A 在 这 种 情况 下 会 被 重新 创建 一 次 。 

这 样 看 上 去 好 像 一 切 正常 ， 可 是 别 忽略 了 一 个 重要 问题 ,活动 A 中 是 可 能 存在 临时 数据 和 
状态 的 。 打 个 比方 ，MainActivity 中 有 一 个 文本 输入 框 ， 现 在 你 输入 了 一 段 文字 ， 然 后 启动 
NormalActivity， 这 时 MainActivity 由 于 系统 内 存 不 足 被 回收 掉 ， 过 了 一 会 你 又 点 击 了 Back 键 回 
到 MainActivity ， 你 会 发 现 刚 刚 输 入 的 文字 全 部 都 没 了 ， 因 为 MainActivity 被 重新 创建 了 。 

如 果 我 们 的 应 用 出 现 了 这 种 情况 , 是 会 严重 影响 用 户 体验 的 , 所 以 必须 要 想 想 办 法 解决 这 个 
问题 。 查 阅 文档 可 以 看 出 ，Activity 中 还 提供 了 一 个 onSaveInstanceState() 回 调 方法 , 这 个 方 
法 可 以 保证 在 活动 被 回收 之 前 一 定 会 被 调用 , 因此 我 们 可 以 通过 这 个 方法 来 解决 活动 被 回收 时 临 
时 数据 得 不 到 保存 的 问题 。 

onSaveInstanceState() 方 法 会 携带 一 个 Bundle 类 型 的 参数 ，Bundle 提供 了 一 系列 的 方 
法 用 于 保存 数据 ， 比 如 可 以 使 用 putString() 方 法 保存 字符 串 , 使 用 putInt() 方 法 保存 整 型 数 
据 , 以 此 类 推 。 每 个 保存 方法 需要 传 入 两 个 参数 , 第 一 个 参数 是 键 , 用 于 后 面 从 Bundle 中 取 值 ， 
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第 二 个 参数 是 真正 要 保存 的 内 容 。 
在 MainActivity 中 添加 如 下 代码 就 可 以 将 临时 数据 进行 保存 : 
@Override 
protected void onSaveInstanceState(Bundle outState) { 
super.onSaveInstanceState(outState); 
String tempData = "Something you just typed"; 
outState.putString("data key", tempData); 
} 
数据 是 已 经 保存 下 来 了 , 那么 我 们 应 该 在 哪里 进行 恢复 呢 ? 细心 的 你 也 许 早 就 发 现 , 我 们 一 
直 使 用 的 onCreate() 方 法 其 实 也 有 一 个 Bundle 类 型 的 参数 ,这 个 参数 在 一 般 情况 下 都 是 null， 
但 是 如 果 在 活动 被 系统 回收 之 前 有 通过 onSaveInstanceState() 方 法 来 保存 数据 的 话 ， 这 个 参 
数 就 会 带 有 之 前 所 保存 的 全 部 数据 ， 我 们 只 需要 再 通过 相应 的 取 值 方法 将 数据 取出 即 可 。 


修改 MainActivity 的 onCreate( ) 方 法 ， 如 下 所 示 : 


GQOverride 
protected void onCreate(Bundle savedInstanceState) { 
super.onCreate(savedInstanceState); 
Log.d(TAG, "onCreate"); 
setContentView(R.layout.activity main); 
if (savedInstanceState != nuLL) { 
String tempData = savedInstanceState.getString("data key"); 
Log.d(TAG, tempData); 


} 


取出 值 之 后 再 做 相应 的 恢复 操作 就 可 以 了 ， 比 如 说 将 文本 内 容重 新 赋值 到 文本 输入 杠 上 , 这 
里 我 们 只 是 简单 地 打印 一 下 。 

不 知道 你 有 没有 察觉 ， 使 用 Bundle 来 保存 和 取出 数据 是 不 是 有 些 似曾相识 呢 ? 没 错 ! 我 们 
在 使 用 Intent 传递 数据 时 也 是 用 的 类 似 的 方法 。 这 里 跟 你 提醒 一 点 ，Intent 还 可 以 结合 Bundle 
一 起 用 于 传递 数据 ， 首 先 可 以 把 需要 传递 的 数据 都 保存 在 Bundle 对 象 中 ， 然 后 再 将 Bundle 对 
象 存放 在 Intent 里 。 到 了 目标 活动 之 后 先 从 Intent 中 取出 Bundle, 再 从 Bundte 中 一 一 取出 数据 。 
具体 的 代码 我 就 不 写 了 ， 要 学 会 举一反三 哦 。 


2.5 活动 的 启动 模式 


活动 的 启动 模式 对 你 来 说 应 该 是 个 全 新 的 概念 , 在 实际 项 目 中 我 们 应 该 根据 特定 的 需求 为 每 
个 活动 指定 恰当 的 启动 模式 。 启 动 模式 一 共有 4 种 ， 分 别 是 standard、singleTop、singleTask 和 
singleInstance, 可 以 在 AndroidManifest.xml 中 通过 给 <activity> 标 签 指定 android:LaunchMode 
盟 性 来 选择 启动 模式 。 下 面 我 们 来 逐个 进行 学 习 。 
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2.5.1 standard 


standard 是 活动 默认 的 启动 模式 ， 在 不 进行 显 式 指定 的 情况 下 ， 所 有 活动 都 会 自动 使 用 这 种 
启动 模式 。 因 此, 到 目前 为 止 我 们 写 过 的 所 有 活动 都 是 使 用 的 standard 模式 。 经 过 上 一 节 的 学 习 ， 
你 已 经 知道 了 Android 是 使 用 返回 栈 来 管理 活动 的 ,在 standard 模式 〈 即 默认 情况 ) 下 ， 每 当 启 
动 一 个 新 的 活动 ， 它 就 会 在 返回 栈 中 和 人 栈 ， 并 处 于 栈 项 的 位 置 。 对 于 使 用 standard 模式 的 活动 ， 
系统 不 会 在 乎 这 个 活动 是 否 已 经 在 返回 栈 中 存在 ， 每 次 启动 都 会 创建 该 活动 的 一 个 新 的 实例 。 


我 们 现在 通过 实践 来 体会 一 下 standard 模式 ， 这 次 还 是 准备 在 ActivityTest 项 目的 基础 上 修 
改 ， 首 先 关 闭 ActivityLifeCycleTest 项 目 ， 打 开 ActivityTest 项 目 。 


修改 FirstActivity 中 onCreate () 方 法 的 代码 ， 如 下 所 示 


@Override 
protected void onCreate(Bundle savedInstanceState) { 
super.onCreate(savedInstanceState); 
Log.d("FirstActivity", this.toString()); 
setContentView(R.layout.first layout); 
Button buttonl = (Button) findViewById(R.id.button 1); 
buttonl.setOnClickListener(new View.0nCLickListener() { 
GOverride 
public void onClick(View v) { 
Intent intent = new Intent(FirstActivity.this, FirstActivity.class); 
startActivity(intent); 


}); 
} 
代码 看 起 来 有 些 奇 怪 吧 , 在 FirstActivity 的 基础 上 启动 FirstActivity。 从 逻辑 上 来 讲 这 确实 没 
什么 意义 ,不 过 我 们 的 重点 在 于 研究 standard 模式 ， 因 此 不 必 在 意 这 段 代码 有 什么 实际 用 途 。 男 
外 我 们 还 在 onCreate() 方 法 中 添加 了 一 行 打印 信息 ， 用 于 打印 当前 活动 的 实例 。 


现在 重新 运行 程序 ， 然 后 在 FirstActivity 界面 连续 点 击 两 次 按钮 ， 可 以 看 到 logcat 中 打印 信 
息 如 图 2.33 所 示 。 
= CC 加 ke [Fr 


com. example. activitytest.FirstActivity@71b88c5 


com. example. activitytest D/FirstActi .example. activitytest. FirstActivity@37b39291 


com. example. activitytest D/FirstAc : com. example.activitytest. FirstActivity@20309892 


图 2.33 standard 模式 下 的 打印 日 志 
从 打印 信息 中 我 们 就 可 以 看 出 ， 每 点 击 一 次 按钮 就 会 创建 出 一 个 新 的 FirstActivity 实例 。 此 
时 返回 栈 中 也 会 存在 3 个 FirstActivity 的 实例 ， 因 此 你 需要 连 按 3 次 Back 键 才 能 退出 程序 。 
standard 模式 的 原理 示意 图 ， 如 图 2.34 所 示 。 
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启动 新 活动 


启动 新 活动 


返回 栈 
图 2.34 ”standard 模式 示意 图 


2.5.2 singleTop 


可 能 在 有 些 情况 下， 你 会 觉得 standard 模式 不 太 合 理 。 活 动 明明 已 经 在 栈 顶 了 ,为 什么 再 次 
启动 的 时 候 还 要 创建 一 个 新 的 活动 实例 呢 ? 别 着 急 , 这 只 是 系统 默认 的 一 种 启动 模式 而 已 , 你 完 
全 可 以 根据 自己 的 需要 进行 修改 ， 比 如 说 使 用 singleTop 模式 。 当 活动 的 启动 模式 指定 为 
singleTop， 在 启动 活动 时 如 果 发 现 返 回 栈 的 栈 顶 已 经 是 该 活动 ， 则 认为 可 以 直接 使 用 它 , 不 会 再 
创建 新 的 活动 实例 。 

我 们 还 是 通过 实践 来 体会 一 下 ， 修改 AndroidManifest.xml 中 FirstActivity 的 启动 模式 ， 如 下 
所 示 : 

<activity 

android:name=" .FirstActivity" 

android:LaunchMode="singLeTop" 

android:label="This is FirstActivity"> 

<intent-filter> 
<action android:name="android,.intent.action.MAIN" /> 
<category android:name="android.intent.category.LAUNCHER" /> 


</intent-filter> 
</activity> 


然后 重新 运行 程序 , 查看 logcat 会 看 到 已 经 创建 了 一 个 FirstActivity 的 实例 , 如 图 2.35 所 示 。 


学 ~ 
[Debug -| @- ) 回 Regex | Firstactivity 


com. example. activitytest D/FirstActivity: com. example. activitytest.FirstActivity@2cd53c9f 


图 2.35 singleTop 模式 下 的 打印 日 志 


但 是 之 后 不 管 你 点 击 多 少 次 按钮 都 不 会 再 有 新 的 打印 信息 出 现 ， 因 为 目前 FirstActivity 已 经 
处 于 返回 栈 的 栈 顶 ， 每 当 想 要 再 启动 一 个 FirstActivity 时 都 会 直接 使 用 栈 顶 的 活动 ， 因 此 
FirstActivity 也 只 会 有 一 个 实例 ， 仅 按 一 次 Back 键 就 可 以 退出 程序 。 


不 过 当 FirstActivity 并 未 处 于 栈 顶 位 置 时 , 这 时 再 启动 FirstActivity, 还 是 会 创建 新 的 实例 的 。 
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下 面 我 们 来 实验 一 下 ， 修 改 FirstActivity 中 onCreate( ) 方 法 的 代码 ， 如 下 所 示 : 


GOverride 
protected void onCreate(Bundle savedInstanceState) { 
super.onCreate(savedInstanceState); 
Log.d("FirstActivity", this.toString()); 
setContentView(R.layout.first layout); 
Button buttonl = (Button) findViewById(R.id.button 1); 
buttonl.setOnClickListener(new View.OnClickListener() { 
GOverride 
public void onClick(View v) { 
Intent intent = new Intent(FirstActivity.this, SecondActivity.class); 
startActivity(intent); 


}); 
4 


这 次 我 们 点 击 按钮 后 启动 的 是 SecondActivity。 然 后 修改 SecondActivity 中 onCreate() 方 法 
的 代码 ， 如 下 所 示 : 


GOverride 
protected void onCreate(Bundle savedInstanceState) { 
super.onCreate(savedInstanceState); 
Log.d("SecondActivity", this.toString()); 
setContentView(R.layout.second Layout ) ; 
Button button2 = (Button) findViewById(R.id.button 2); 
button2.setOnClickListener(new View.0nCLickListener() { 
GOverride 
public void onClick(View v) { 
Intent intent = new Intent(SecondActivity.this, FirstActivity.class); 
startActivity(intent); 


}); 
} 


我 们 在 SecondActivity 中 的 按钮 点 击 事件 里 又 加 入 了 启动 FirstActivity 的 代码 。 现 在 重新 运 
行程 序 ， 在 FirstActivity 界面 点 击 按钮 进入 到 SecondActivity， 然 后 在 SecondActivity 界面 点 击 按 
钮 ， 又 会 重新 进入 到 FirstActivity。 


查看 logcat 中 的 打印 信息 ， 如 图 2.36 所 示 。 


es ~ 
|pebue 国 (QrActivity: 3) 回 Regex | Show only 


com. example. activitytest D/FirstActivity: com. example.activitytest.FirstActivity@2cd53c9f 
com. example. activitytest D/SecondActivity: com. example.activitytest. SecondActivity@3c50d14 
com. example. activitytest D/FirstActivity: com. example.activitytest. FirstActivity@215dbad3 


图 2.36 singleTop 模式 下 的 打印 日 志 
可 以 看 到 系统 创建 了 两 个 不 同 的 FirstActivity 实例 ， 这 是 由 于 在 SecondActivity 中 再 次 启动 
FirstActivity 时 ， 栈 顶 活动 已 经 变 成 了 SecondActivity， 因 此 会 创建 一 个 新 的 FirstActivity 实例 。 
现在 按 下 Back 键 会 返回 到 SecondActivity， 再 次 按 下 Back 键 又 会 回 到 FirstActivity， 再 按 一 次 
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Back 键 才 会 退出 程序 。 
singleTop 模式 的 原理 示意 图 ， 如 图 2.37 所 示 。 


检查 栈 顶 判 


断 是 否 需要 


启动 新 活动 i 
SecondActivity 


启动 新 活动 


FirstActivity 


返回 栈 
图 2.37 singleTop 模式 示意 图 


2.5.3 singleTask 


使 用 singleTop 模式 可 以 很 好 地 解决 重复 创建 栈 项 活动 的 问题 ,但 是 正如 你 在 上 一 节 所 看 到 
的 ， 如果 该 活动 并 没有 人 处 于 栈 顶 的 位 置 , 还 是 可 能 会 创建 多 个 活动 实例 的 。 那么 有 没有 什么 办 法 
可 以 让 某 个 活动 在 整个 应 用 程序 的 上 下 文中 只 存在 一 个 实例 呢 ? 这 就 要 借助 sngleTask 模式 来 实 
现 了 。 当 活动 的 启动 模式 指定 为 singleTask， 每 次 启动 该 活动 时 系统 首先 会 在 返回 栈 中 检查 是 否 
存在 该 活动 的 实例 , 如 果 发 现 已 经 存在 则 直接 使 用 该 实例 , 并 把 在 这 个 活动 之 上 的 所 有 活动 统统 
出 栈 ， 如 果 没 有 发 现 就 会 创建 一 个 新 的 活动 实例 。 


我 们 还 是 通过 代码 来 更 加 直观 地 理解 一 下 。 修 改 AndroidManifestxml 中 FirstActivity 的 启动 
模式 : 
<activity 
android:name=" .FirstActivity" 
android:launchMode="singleTask" 
android:label="This is FirstActivity"> 
<intent-filter> 
<action android:name="android,.intent.action.MAIN" /> 
<category android:name="android.intent.category.LAUNCHER" /> 
</intent-filter> 


</activity> 
然后 在 FirstActivity 中 添加 onRestart() 方 法 ， 并 打印 日 志 : 
@Override 


protected void onRestart() { 
super.onRestart(); 
Log.d("FirstActivity", "onRestart"),; 
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最 后 在 SecondActivity 中 添加 onDest roy ( ) 方 法 ， 并 打印 日 志 : 


GOverride 

protected void onDestroy() { 
super.onDestroy(); 
Log.d("SecondActivity", "onDestroy"); 

} 


现在 重新 运行 程序 ， 在 FirstActivity 界面 点 击 按钮 进入 到 SecondActivity， 然 后 在 Second- 
Activity 界面 点 击 按钮 ， 又 会 重新 进入 到 FirstActivity。 


查看 logcat 中 的 打印 信息 ， 如 图 2.38 所 示 。 
BC ow 区 本 


com. example. activitytest D/FirstActivity: com example.activitytest.FirstActivity@186799b5 


com. example. activitytest D/SecondActivity: com. example. activitytest. SecondActivity@3c50d14 
com. example. activitytest D/FirstActivity: onRestart 
com. example. activitytest D/SecondActivity: onDestroy 


图 2.38 ”singleTask 模式 下 的 打印 日 志 


其 实 从 打印 信息 中 就 可 以 明显 看 出 了 ， 在 SecondActivity 中 启动 FirstActivity 时 ， 会 发 现 返 
回 栈 中 已 经 存在 一 个 FirstActivity 的 实例 ， 并 且 是 在 SecondActivity 的 下 面 ， 于 是 SecondActivity 
会 从 返回 栈 中 出 栈 ， 而 FirstActivity 重新 成 为 了 栈 顶 活动 ， 因 此 FirstActivity 的 onRestart ( ) 方 
法 和 SecondActivity 的 onDestroy () 方 法 会 得 到 执行 .现在 返回 栈 中 应 该 只 剩 下 一 个 FirstActivity 
的 实例 了 ， 按 一 下 Back 键 就 可 以 退出 程序 。 


singleTask 模式 的 原理 示意 图 ， 如 图 2.39 所 示 。 


直接 出 栈 来 重新 回 到 FirstActivity 


启动 SecondActivity 


FirstActivity 


返回 栈 
图 2.39 singleTask 模式 示意 图 
2.5.4 singlelnstance 


singleInstance 模式 应 该 算是 4 种 启动 模式 中 最 特殊 也 最 复杂 的 一 个 了 , 你 也 需要 多 花 点 功夫 
来 理解 这 个 模式 。 不 同 于 以 上 3 种 启动 模式 , 指定 为 sngleInstance 模式 的 活动 会 局 用 一 个 新 的 返 


2.$ 活动 的 启动 模式 69 


回 栈 来 管理 这 个 活动 (其实 如 果 singleTask 模式 指定 了 不 同 的 taskAffinity ， 也 会 启动 一 个 新 的 返 
回 栈 )。 那 么 这 样 做 有 什么 意义 呢 ? 想象 以 下 场景 ， 假 设 我 们 的 程序 中 有 一 个 活动 是 允许 其 他 程 
序 调用 的 , 如 果 我 们 想 实 现 其 他 程序 和 我 们 的 程序 可 以 共享 这 个 活动 的 实例 , 应 该 如 何 实现 呢 ? 
使 用 前 面 3 种 启动 模式 肯定 是 做 不 到 的 ,因为 每 个 应 用 程序 都 会 有 自己 的 返回 栈 ,同一 个 活动 在 
不 同 的 返回 栈 中 和 人 栈 时 必然 是 创建 了 新 的 实例 。 而 使 用 singleInstance 模式 就 可 以 解决 这 个 问题 ， 
在 这 种 模式 下 会 有 一 个 单独 的 返回 栈 来 管理 这 个 活动 , 不 管 是 哪个 应 用 程序 来 访问 这 个 活动 , 都 
共用 的 同一 个 返回 栈 ， 也 就 解决 了 共享 活动 实例 的 问题 。 

为 了 帮助 你 更 好 地 理解 这 种 启动 模式 ， 我 们 还 是 来 实践 一 下 。 修 改 AndroidManifestxml 中 
SecondActivity 的 启动 模式 : 


<activity android:name=".SecondActivity" 
android:LaunchMode="singLeInstance"> 
<intent-filter> 
<action android:name="com.example.activitytest.ACTION START" /> 
<category android:name="android,.intent.category.DEFAULT" /> 
<category android:name="com.example.activitytest.MY CATEGORY" /> 
</intent-filter> 
</activity> 


我 们 先 将 SecondActivity 的 启动 模式 指定 为 singleInstance ， 然 后 修改 FirstActivity 中 
onCreate() 方 法 的 代码 : 


@Override 
protected void onCreate(Bundle savedInstanceState) { 
super.onCreate(savedInstanceState), 
Log.d("FirstActivity", "Task id is " + getTaskId()); 
SetContentView(R.Layout .first layout); 
Button buttonl = (Button) findViewById(R.id.button 1); 
buttonl.setOnClickListener(new View.0nCLickListener() { 
@Override 
public void onClick(View v) { 
Intent intent = new Intent(FirstActivity.this, SecondActivity.class); 
startActivity(intent); 


}); 
} 


在 onCreate() 方 法 中 打印 了 当前 返回 栈 的 id。 然 后 修改 SecondActivity 中 onCreate() 方 
法 的 代码 : 


GQOverride 

protected void onCreate(Bundle savedInstanceState) { 
super.onCreate(savedInstanceState); 
Log.d("SecondActivity", "Task id is " + getTaskId()); 
setContentView(R.layout.second layout); 
Button button2 = (Button) findViewById(R.id.button 2); 
button2.setOnClickListener(new View.0nCLickListener() { 

@Override 
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public void onClick(View v) { 
Intent intent = new Intent(SecondActivity.this, ThirdActivity.class); 
startActivity(intent); 


}); 
} 


同样 在 onCreate() 方 法 中 打印 了 当前 返回 栈 的 id, 然后 又 修改 了 按钮 点 击 事件 的 代码 , 用 
于 启动 ThirdActivity。 最 后 修改 ThirdActivity 中 onCreate( ) 方 法 的 代码 : 


@Override 

protected void onCreate(Bundle savedInstanceState) { 
super.onCreate(savedInstanceState); 
Log.d("ThirdActivity", "Task id is " + getTaskId()); 
setContentView(R.layout.third layout); 


} 


仍然 是 在 onCreate() 方 法 中 打印 了 当前 返回 栈 的 id。 现 在 重新 运行 程序 ， 在 FirstActivity 
界面 点 击 按钮 进入 到 SecondActivity， 然 后 在 SecondActivity 界面 点 击 按钮 进入 到 ThirdActivity。 


查看 logcat 中 的 打印 信息 ， 如 图 2.40 所 示 。 


| pebue 日 @- Activity: 3) 


com. example. activitytest D/FirstActivity: Task id is 171 


com. example. activitytest D/SecondActivity: Task id is 172 


com. example. activitytest D/ThirdActivity: Task id is 171 


图 2.40 singleInstance 模式 下 的 打印 日 志 


可 以 看 到 ，SecondActivity 的 Task id 不 同 于 FirstActivity 和 ThirdActivity ， 这 说 明 
SecondActivity 确实 是 存放 在 一 个 单独 的 返回 栈 里 的 ， 而 且 这 个 栈 中 只 有 SecondActivity 这 一 个 
活动 。 

然后 我 们 按 下 Back 键 进 行 返 回 ， 你 会 发 现 ThirdActivity 竟然 直接 返回 到 了 FirstActivity， 
再 按 下 Back 键 又 会 返回 到 SecondActivity, 再 按 下 Back 键 才 会 退出 程序 , 这 是 为 什么 呢 ? 其 实 
原理 很 简单 ， 由 于 FirstActivity 和 ThirdActivity 是 存放 在 同一 个 返回 栈 里 的 ， 当 在 ThirdActivity 
的 界面 按 下 Back 键 ，ThirdActivity 会 从 返回 栈 中 出 栈 ， 那 么 FirstActivity 就 成 为 了 栈 顶 活动 显 
示 在 界面 上 ， 因 此 也 就 出 现 了 从 ThirdActivity 直接 返回 到 FirstActivity 的 情况 。 然 后 在 
FirstActivity 界面 再 次 按 下 Back 键 ， 这 时 当前 的 返回 栈 已 经 空 了 ， 于 是 就 显示 了 另 一 个 返回 栈 
的 栈 顶 活动 ， 即 SecondActivity。 最 后 再 次 按 下 Back 键 ， 这 时 所 有 返回 栈 都 已 经 空 了 ， 也 就 自 
然 退 出 了 程序 。 


singleInstance 模式 的 原理 示意 图 ， 如 图 2.41 所 示 。 
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启动 新 活动 


高 


启动 新 活动 


SecondActivity 


图 2.41 ”singleInstance 模式 示意 图 


2.6 活动 的 最 佳 实践 


你 已 经 掌握 了 关于 活动 非常 多 的 知识 , 不 过 疏 人 离 能 够 完全 灵活 运用 还 有 一 段 距离 。 虽 然 知 
识 点 只 有 这 人 么 多 , 但 运用 的 技巧 却 是 多 种 多 样 的 。 所 以 , 在 这 里 我 准备 教 你 几 种 关于 活动 的 最 佳 
实践 技巧 ， 这 些 技巧 在 你 以 后 的 开发 工作 当中 将 会 非常 有 用 。 


2.6.1 知晓 当前 是 在 哪 一 个 活动 


这 个 技巧 将 教会 你 如 何 根据 程序 当前 的 界面 就 能 判断 出 这 是 哪 一 个 活动 。 可 能 你 会 觉得 挺 纳 
浆 的 ,我 自己 写 的 代码 怎么 会 不 知道 这 是 哪 一 个 活动 呢 ? 很 不 幸 的 是 ,在 你 真正 进入 到 企业 之 后 ， 
更 有 可 能 的 是 接手 一 份 别 人 写 的 代码 ， 因 为 你 刚 进 公司 就 正好 有 一 个 新 项 目 启 动 的 概率 并 不 高 。 
阅读 别人 的 代码 时 有 一 个 很 头疼 的 问题 ， 就 是 当 你 需要 在 某 个 界面 上 修改 一 些 非常 简单 的 东西 
时 ， 却 半天 找 不 到 这 个 界面 对 应 的 活动 是 哪 一 个 。 学 会 了 本 节 的 技巧 之 后 ,这 对 你 来 说 就 再 也 不 
是 难题 了 。 

我 们 还 是 在 ActivityTest 项 目的 基础 上 修改 ， 首 先 需要 新 建 一 个 BaseActivity 类 。 碳 击 
com.example.activitytest 包 一 New 一 Java Class , 在 弹出 的 窗口 出 输入 BaseActivity, 如 图 2.42 所 示 。 


万 Create New Co NI 


[BaseActivity ] 1 


me: 
nd: © Class 图 
WE [ee 


ame: 


N: 
Ki 


图 2.42 创建 BaseActivity 类 
注意 这 里 BaseActivity 和 普通 活动 的 创建 方式 并 不 一 样 ， 因 为 我 们 不 需要 让 
BaseActivity 在 AndroidManifest.xml 中 注册 , 所 以 选择 创建 一 个 普通 的 Java 类 就 可 以 了 。 然后 
让 BaseActivity 继承 自 AppCompatActivity， 并 重 写 onCreate() 方 法 ， 如 下 所 示 : 
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public class BaseActivity extends AppCompatActivity { 


@Override 


protected void onCreate(Bundle savedInstanceState) { 
super.onCreate(savedInstanceState);, 
Log.d("BaseActivity", getClass().getSimpleName()); 


} 


我 们 在 onCreate() 方 法 中 获取 了 当前 实例 的 类 名 ， 并 通过 Log 打印 了 出 来 。 

接 下 来 我 们 需要 让 BaseActivity 成 为 ActivityTest 项 目 中 所 有 活动 的 父 类 。 修 改 First- 
Activity 、SecondActivity 和 ThirdActivity 的 继承 结构 ， 让 它们 不 再 继承 自 AppCompatActivity， 
而 是 继承 自 BaseActivity。 而 由 于 BaseActivity 又 是 继承 自 AppCompatActivity 的 ， 所 以 
项 目 中 所 有 活动 的 现 有 功能 并 不 受 影 响 ， 它 们 仍然 完全 继承 了 Activity 中 的 所 有 特性 。 

现在 重新 运行 程序 ， 然 后 通过 点 击 按钮 分 别 进入 到 FirstActivity 、SecondActivity 和 Third- 


Activity 的 界面 ， 这 时 观察 logcat 中 的 打印 信息 ， 如 图 


com. example. activitytest D/BaseActivity: 


com. example. activitytest D/BaseActivity: 


com. example. activitytest D/BaseActivity: 


2.43 BaseActivity 中 


2.43 所 示 。 


Debug 


FirstA 


-RR 5 


ctivity 


SecondActivity 


ThirdA 


ctivity 


的 打印 日 志 


现在 每 当 我 们 进入 到 一 个 活动 的 界面 , 该 活动 的 类 名 就 会 被 打印 出 来 , 这 样 我 们 就 可 以 时 时 


刻 刻 知晓 当前 界面 对 应 的 是 哪 一 个 活动 了 。 


2.6.2 ”随时 随地 退出 程序 


如 果 目 前 你 手机 的 界面 还 停留 在 ThirdActivity ， 你 会 发 现 当前 想 退 出 程序 是 非常 不 方便 的 ， 


需要 连 按 3 次 Back 键 才 行 。 按 Home 键 只 是 把 


程 


E 序 提 


起 ， 并 没有 退出 程序 。 其 实 这 个 问题 就 足 


以 引起 你 的 思考 , 如 果 我 们 的 程序 需要 一 个 注销 或 者 退出 的 功能 该 怎么 办 呢 ? 必须 要 有 一 个 随时 


随地 都 能 退出 程序 的 方案 才 行 。 


其 实 解决 思路 也 很 简单 ， 只 需要 用 一 个 专门 的 集合 类 对 所 有 的 活动 进行 管理 就 可 以 了 , 下 面 


我 们 就 来 实现 一 下 。 


新 建 一 个 ActivityCollector 类 作为 活动 管理 器 ， 代 码 如 下 所 示 : 


public class ActivityCollector { 


public static List<Activity> activities 


= new ArrayList<>(); 


public static void addActivity(Activity activity) { 


activities.add(activity); 
} 
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public static void removeActivity(Activity activity) { 
activities.remove(activity); 


} 


public static void finishALL() { 
for (Activity activity : activities) { 
if (lactivity.isFinishing()) { 
activity.finish(); 
} 
} 


activities.clear(); 


} 


在 活动 管理 器 中 ， 我 们 通过 一 个 List 来 暂 存活 动 ， 然 后 提供 了 一 个 addActivity() 方 法 用 
于 向 List 中 添加 一 个 活动 , 提供 了 一 个 removeActivity() 方 法 用 于 从 List 中 移 除 活动 , 最 后 提 
供 了 一 个 finishALL() 方 法 用 于 将 List 中 存储 的 活动 全 部 销毁 掉 。 

接 下 来 修改 BaseActivity 中 的 代码 ， 如 下 所 示 : 


public class BaseActivity extends AppCompatActivity { 


@Override 

protected void onCreate(Bundle savedInstanceState) { 
super.onCreate(savedInstanceState); 
Log.d("BaseActivity", getClass().getSimpleName()); 
ActivityCollector.addActivity(this); 

} 


@Override 

protected void onDestroy() { 
super.onDestroy(); 
ActivityCollector.removeActivity(this); 


} 


在 BaseActivity 的 onCreate() 方 法 中 调用 了 ActivityCollector 的 addActivity() 方 
法 ,表明 将 当前 正在 创建 的 活动 添加 到 活动 管理 带 里 ,然后 在 BaseActivity 中 重 写 onDestroy() 
方法 ， 并 调用 了 ActivityCollector 的 removeActivity() 方 法 ， 表明 将 一 个 马上 要 销毁 的 活 
动 从 活动 管理 器 里 移 除 。 

从 此 以 后 , 不 管 你 想 在 什么 地 方 退出 程序 ,只 需要 调用 ActivityCollector.finishAl1() 
方法 就 可 以 了 。 例如 在 ThirdActivity 界面 想 通 过 点 击 按钮 直接 退出 程序 ， 只 需 将 代码 改 成 如 下 
所 示 : 


public class ThirdActivity extends BaseActivity { 


GOverride 
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protected void onCreate(Bundle savedInstanceState) { 
super.onCreate(savedInstanceState);, 
Log.d("ThirdActivity", "Task id is " + getTaskId()); 
setContentView(R.layout.third layout); 
Button button3 = (Button) findViewById(R.id.button 3); 
button3.setOnClickListener(new View.0nCLickListener() { 
@Override 
public void onClick(View v) { 
ActivityCollector.finishAll(); 
} 
}); 


} 

当然 你 还 可 以 在 销毁 所 有 活动 的 代码 后 面 再 加 上 杀 掉 当前 进程 的 代码 ， 以 保证 程序 完全 退 
出 ， 杀 掉 进 程 的 代码 如 下 所 示 : 

android.os.Process.kiLLProcess(android.os.Process.myPid() ) ; 

其 中 ，kiLLProcess () 方 法 用 于 杀 掉 一 个 进程 ， 它 接收 一 个 进程 id 参数 ， 我 们 可 以 通过 
myPid() 方 法 来 获得 当前 程序 的 进程 id。 需要 注意 的 是 , kiLLProcess () 方 法 只 能 用 于 杀 掉 当前 
程序 的 进程 ， 我 们 不 能 使 用 这 个 方法 去 杀 掉 其 他 程序 。 


2.6.3 ”启动 活动 的 最 佳 写 ; 


启动 活动 的 方法 相信 你 已 经 非常 熟悉 了 ， 首 先 通过 Intent 构建 出 当前 的 “意图 ”， 然 后 调用 
startActivity() 或 startActivityForResutLt () 方 法 将 活动 启动 起 来 ， 如 果 有 数据 需要 从 
个 活动 传递 到 另 一 个 活动 ， 也 可 以 借助 Intent 来 完成 。 

假设 SecondActivity 中 需要 用 到 两 个 非常 重要 的 字符 串 参 数 ， 在 启动 SecondActivity 的 时 候 
必须 要 传递 过 来 ， 那 么 我 们 很 容易 会 写 出 如 下 代码 : 

Intent intent = new Intent(FirstActivity.this, SecondActivity.class); 

intent.putExtra("paraml", "datal"); 


intent.putExtra("param2", "data2"); 
startActivity(intent); 


这 样 写 是 完全 正确 的 , 不 管 是 从 语法 上 还 是 规范 上 ,只 是 在 真正 的 项 目 开 发 中 经 常会 有 对 接 
的 问题 出 现 。 比 如 SecondActivity 并 不 是 由 你 开发 的 ， 但 现在 你 负责 的 部 分 需要 有 启动 
SecondActivity 这 个 功能 ， 而 你 却 不 清楚 启动 这 个 活动 需要 传递 哪些 数据 。 这 时 无 非 就 有 两 种 办 
法 ,一 个 是 你 自己 去 阅读 SecondActivity 中 的 代码 ， 二 是 询问 负责 编写 SecondActivity 的 同事 。 
你 会 不 会 觉得 很 麻烦 呢 ? 其 实 只 需要 换 一 种 写法 ， 就 可 以 轻松 解决 掉 上 面 的 窘境 。 

修改 SecondActivity 中 的 代码 ， 如 下 所 示 : 


public class SecondActivity extends BaseActivity { 
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public static void actionStart(Context context, String datal, String data2) { 
Intent intent = new Intent(context, SecondActivity.class); 
intent.putExtra("paraml", datal); 
intent.putExtra("param2", data2); 
context.startActivity(intent); 


} 


我 们 在 SecondActivity 中 添加 了 一 个 actionStart() 方 法 ,在 这 个 方法 中 完成 了 Intent 的 构 
建 , 另外 所 有 SecondActivity 中 需要 的 数据 都 是 通过 actionStart() 方 法 的 参数 传递 过 来 的 , 然 
后 把 它们 存储 到 Intent 中 ， 最 后 调用 startActivity() 方 法 启动 SecondActivity。 


这 样 写 的 好 处 在 哪里 呢 ? 最 重要 的 一 点 就 是 一 目 了 然 ，SecondActivity 所 需要 的 数据 在 方法 
参数 中 全 部 体现 出 来 了 ， 这 样 即 使 不 用 阅读 SecondActivity 中 的 代码 ， 不 去 询问 负责 编写 
SecondActivity 的 同事 ， 你 也 可 以 非常 清晰 地 知道 启动 SecondActivity 需要 传递 哪些 数据 。 另 外 ， 
这 样 写 还 简化 了 启动 活动 的 代码 ， 现 在 只 需要 一 行 代码 就 可 以 启动 SecondActivity， 如 下 所 示 

buttonl.setOnClickListener(new OnClickListener() { 

@Override 


public void onClick(View v) { 
SecondActivity.actionStart(FirstActivity.this, "datal", "data2"); 


} 
3 
养 成 一 个 良好 的 习惯 , 给 你 编写 的 每 个 活动 都 添加 类 似 的 启动 方法 , 这 样 不 仅 可 以 让 启动 活 
动 变 得 非常 简单 ， 还 可 以 节省 不 少 你 同事 过 来 询问 你 的 时 间 。 


2.7 小结 与 点评 


真是 好 疲惫 啊 ! 没 错 , 学 习 了 这 么 多 的 东西 不 疲惫 才 怪 呢 。 但 是 , 你 内 心 那 种 掌握 了 知识 的 
喜悦 感 相信 也 是 无 法 掩盖 的 。 本 章 的 收获 非常 多 啊 ， 不 管 是 理论 型 还 是 实践 型 的 东西 都 涉及 了 ， 
从 活动 的 基本 用 法 , 到 启动 活动 和 传递 数据 的 方式 , 再 到 活动 的 生命 周期 , 以 及 活动 的 启动 模式 ， 
你 几乎 已 经 学 会 了 关于 活动 所 有 重要 的 知识 点 。 另 外 在 本 章 的 最 后 , 还 学 习 了 几 种 可 以 应 用 在 活 
动 中 的 最 佳 实践 技巧 ， 毫 不 夸张 地 说 ， 你 在 Android 活动 方面 已 经 算是 一 个 小 高 手 了 。 

不 过 你 的 Android 旅途 才刚 刚 开始 呢 ， 后面 需 要 学 习 的 东西 还 很 多 ， 也许 会 比 现在 还 累 ,一 
定 要 做 好 心理 准备 哦 。 总 体 来 说 ， 我 给 你 现在 的 状态 打 满分 ， 毕 竟 你 已 经 学 会 了 那么 多 的 东西 ， 
也 是 时 候 放松 一 下 了 。 自 己 适当 控制 一 下 休息 的 时 间 ， 然 后 我 们 继续 前 进 吧 ! 


入 和 人 


GE 


3 章 


软件 也 要 拼 脸 蛋 一 一 UI 开发 的 点 点 滴 滴 


我 一 直 都 认为 程序 员 在 软件 的 审美 方面 普遍 都 比较 差 , 至 少 我 个 人 就 是 如 此 。 如 果 说 要 追究 


其 根本 原因 , 我 觉得 这 是 由 程序 员 的 工作 性 质 所 导致 的 。 每 当 我 们 看 到 一 个 软件 时 ,不 会 像 普 通 
用 户 那 样 仅仅 是 关注 一 下 它 的 界面 和 功能 , 而 是 会 不 自觉 地 思考 这 些 功 能 是 如 何 实 现 的 。 很 多 在 


普通 用 户 看 来 理 所 应 当 的 功能 , 背后 可 能 却 需要 非常 复杂 的 逻辑 来 完成 , 以 至 于 当 别 人 唾骂 一 名 


“这 软件 做 得 真 丑 ”的 时 候 ， 我 们 还 可 能 赞叹 一 句 “这 功能 做 得 好 牛 啊 ”! 
不 过 缺乏 审美 观 毕 况 不 是 一 件 值 得 炫 炊 的 事情 , 在 软件 开发 过 程 中 , 界面 设计 和 功能 开发 同 


样 重要 。 界 面 美观 的 应 用 程序 不 仅 可 以 大 大 增加 用 户 粘性 , 还 能 帮 我 们 吸引 到 更 多 的 新 用 户 。 而 
Android 也 给 我 们 提供 了 大 量 的 UI 开发 工具 ,只 要 合理 地 使 用 它们 , 就 可 以 编写 出 各 种 各 样 漂亮 
的 界面 。 

在 这 里 ， 我 无 法 教会 你 如 何 提升 自己 的 审美 观 ， 但 我 可 以 教会 你 怎样 使 用 Android 提供 的 
UI 开发 工具 来 编写 程序 界面 。 你 在 上 一 章 中 反 反 复 复 地 使 用 那 几 个 按钮 ， 想 必 都 快要 吐 了 吧 ， 
本 章 我 们 就 来 学 习 更 多 的 UI 开发 方面 的 知识 。 


3.1 


如 何 编写 程序 表面 


Android 中 有 多 种 编写 程序 界面 的 方式 可 供 选择 。Android Studio 和 Eclipse 中 都 提供 了 相应 
的 可 视 化 编辑 器 ， 人 允许 使 用 拖 放 控件 的 方式 来 编写 布局 ,并 能 在 视图 上 直接 修改 控件 的 属性 。 不 
过 我 并 不 推荐 你 使 用 这 种 方式 来 编写 界面 , 因为 可 视 化 编辑 工具 并 不 利于 你 去 真正 了 解 界面 背后 
的 实现 原理 。 通过 这 种 方式 制作 出 的 界面 通常 不 具有 很 好 的 屏幕 适 配 性 , 而 且 当 需要 编写 较为 复 
杂 的 界面 时 ,可视化 编辑 工具 将 很 难 胜任 ,因此 本 书 中 所 有 的 界面 都 将 通过 最 基本 的 方式 去 实现 ， 
即 编写 XML 代码 。 等 你 完全 掌握 了 使 用 XML 来 编写 界面 的 方法 之 后 ， 不 管 是 进行 高 复杂 度 的 
界面 实现 ， 还 是 分 析 和 修改 当前 现 有 界面 ， 对 你 来 说 都 将 是 手 到 擒 来 。 


i 


pd ey 


了 这 么 多 理论 的 东西 ,也 是 时 候 学 习 一 下 到 底 如 何 编写 程序 界面 了 ,下 面 我 们 就 从 Android 


中 几 种 常见 的 控件 开始 吧 。 
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3.2 ”常用 控件 的 使 用 方法 

Android 提供 了 大 量 的 UI 控件 , 合理 地 使 用 这 些 控 件 就 可 以 非常 轻松 地 编写 出 相当 不 错 的 界 
面 ， 下 面 我 们 就 挑选 几 种 常用 的 控件 ， 详 细 介 绍 一 下 它们 的 使 用 方法 。 

首先 新 建 一 个 UIWidgetTest 项 目 ， 简 单 起 见 ， 我们 还 是 允许 Android Studio 自动 创建 活动 ， 
活动 名 和 布局 名 都 使 用 默认 值 。 


3.2.1 TextView 


TextView 可 以 说 是 Android 中 最 简单 的 一 个 控件 了 ,你 在 前 面 其 实 已 经 和 它 打 过 一 些 交 道 了 。 
它 主 要 用 于 在 界面 上 显示 一 段 文本 信息 ， 比 如 你 在 第 1 章 看 到 的 “Hello world!1”。 下 面 我 们 就 来 
看 一 看 关于 TextView 的 更 多 用 法 。 


修改 activity_main.xml 中 的 代码 ， 如 下 所 示 : 


<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:orientation="vertical" 
android:layout width="match parent" 
android:layout height="match parent"> 


<TextView 
android:id="@+id/text view" 
android:layout width="match parent" 
android:layout height="wrap content" 
android:text="This is TextView" /> 


</LinearLayout> 


外 面 的 LinearLayout 先 忽 略 不 看 ,在 TextView 中 我 们 使 用 android:id 给 当前 控件 定义 了 一 
个 唯一 标识 符 ， 这 个 属性 在 上 一 章 中 已 经 讲解 过 了 。 然 后 使 用 android:layout width 和 
android:Layout_height 指定 了 控件 的 宽度 和 高 度 。Android 中 所 有 的 控件 都 具有 这 两 个 属性 ， 
可 选 值 有 3 种 : match parent、fill parent 和 wrap_content。 其 中 match parent 和 
fiLL_parent 的 意义 相同 ， 现 在 官方 更 加 推荐 使 用 match_parent。match_parent 表示 让 当前 
控件 的 大 小 和 父 布局 的 大 小 一 样 ， 也 就 是 由 父 布局 来 决定 当前 控件 的 大 小 。wrap_content 表示 
让 当前 控件 的 大 小 能 够 刚好 包含 住 里 面 的 内 容 , 也 就 是 由 控件 内 容 决 定 当 前 控件 的 大 小 。 所 以 上 
面 的 代码 就 表示 让 TextView 的 宽度 和 父 布局 一 样 宽 ， 也 就 是 手机 屏幕 的 宽度 ， 让 TextView 的 高 
度 足 够 包含 住 里 面 的 内 容 就 行 。 当 然 除 了 使 用 上 述 值 , 你 也 可 以 对 控件 的 宽 和 高 指定 一 个 固定 的 
大 小 ， 但 是 这 样 做 有 时 会 在 不 同 手机 屏幕 的 适 配 方面 出 现 问题 。 

接 下 来 我 们 通过 android:text 指定 TextView 中 显示 的 文本 内 容 ， 现 在 运行 程序 ， 效 果 如 
图 3.1 所 示 。 
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5 12:28 
UIWidgetTest 


This is TextView 


图 3.1 TextView 运行 效果 


虽然 指定 的 文本 内 容 正常 显示 了 ， 不 过 我 们 好 像 没 看 出 来 TextView 的 宽度 是 和 屏幕 一 样 宽 
的 。 其 实 这 是 由 于 TextView 中 的 文字 默认 是 居 左 上 角 对 齐 的 ， 虽 然 TextView 的 宽度 充满 了 整个 
屏幕 ， 可 是 由 于 文字 内 容 不 够 长 ， 所 以 从 效果 上 完全 看 不 出 来 。 现 在 我 们 修改 TextView 的 文字 
对 齐 方式 ， 如 下 所 示 : 


<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:orientation="vertical" 
android:layout width="match parent" 
android:layout height="match parent"> 


<TextView 
android:id="@+id/text view" 
android:layout width="match parent" 
android:layout height="wrap content" 
android:gravity="center" 
android:text="This is TextView" /> 


</LinearLayout> 


我 们 使 用 android:gravity 来 指定 文字 的 对 齐 方 式 , 可 选 值 有 top、bottom、 left、right、 
center 等 ， 可 以 用 “|” 来 同时 指定 多 个 值 ， 这 里 我 们 指定 的 center ， 效 果 等 同 于 center_ 
verticaL|center_horizontaL， 表 示 文 字 在 垂直 和 水 平方 向 都 居中 对 齐 。 现 在 重新 运行 程序 ， 
效果 如 图 3.2 所 示 。 
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图 3.2” ”TextView 居中 效果 


这 也 说 明了 TextView 的 宽度 确实 是 和 屏幕 宽度 一 样 的 。 

另外 我 们 还 可 以 对 TextView 中 文字 的 大 小 和 颜色 进行 修改 ， 如 下 所 示 : 

<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:orientation="vertical" 


android:layout width="match parent" 
android:layout height="match parent"> 


<TextView 
android:id="@+id/text View” 
android:layout width="match parent" 
android:layout height="wrap content" 
android:gravity="center" 
android: textSize="24sp" 
android: textColor="#00ff00" 
android:text="This is TextView" /> 


</LinearLayout> 


通过 android :textSize 属性 可 以 指定 文字 的 大 小 , 通过 android:textColor 属性 可 以 指 
定 文字 的 颜色 ， 在 Android 中 字体 大 小 使 用 sp 作为 单位 。 重 新 运行 程序 ， 效 果 如 图 3.3 所 示 。 
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B12:57 
UIWidgetTest 


图 3.3 ”改变 TextView 文字 大 小 和 颜色 的 效果 


当然 TextView 中 还 有 很 多 其 他 的 属性 ， 这 里 就 不 再 一 一 介绍 了 ， 用 到 的 时 候 去 查阅 文档 就 
可 以 了 。 


3.2.2 Button 


Button 是 程序 用 于 和 用 户 进行 交互 的 一 个 重要 控件 ,相信 你 对 这 个 控件 已 经 非常 熟悉 了 ， 
为 我 们 在 上 一 章 用 了 大 多 次 Button。 它 可 配置 的 属性 和 TextView 是 差不多 的 ， 我 们 可 以 在 
activity_main.xml 中 这 样 加 入 Button: 


<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:orientation="vertical" 
android:layout width="match parent" 
android:layout height="match parent"> 


<Button 
android:id="@+id/button" 
android:Tlayout width="match_parent" 
android:layout height="wrap_content" 
android: text="Button" /> 


</LinearLayout> 


加 入 Button 之 后 的 界面 如 图 3.4 所 示 。 
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UIWidgetTest 


BUTTON 


图 3.4 Button 运行 效果 


细心 的 你 可 能 会 留意 到 ， 我 们 在 布局 文件 里 面 设置 的 文字 是 “Button”,， 但 最 终 的 显示 结果 
却 是 “BUTTON”。 这 是 由 于 系统 会 对 Button 中 的 所 有 英文 字母 自动 进行 大 写 转换 ， 如 果 这 不 是 
你 想 要 的 效果 ， 可 以 使 用 如 下 配置 来 禁用 这 一 默认 特性 : 
<Button 
android:id="@+id/button" 
android:layout width="match parent" 
android:layout height="wrap content" 


android:text="Button" 
android:textAllCaps="false" /> 


接 下 来 我 们 可 以 在 MainActivity 中 为 Button 的 点 击 事件 注册 一 个 监听 器 ， 如 下 所 示 : 


public class MainActivity extends AppCompatActivity { 


@Override 
protected void onCreate(Bundle savedInstanceState) { 
super.onCreate(savedInstanceState); 
setContentView(R.layout.activity main); 
Button button = (Button) findViewById(R.id.button); 
button.setOnClickListener (new View.0nCLickListener() { 
@Override 
public void onClick(View v) { 
// 在 此 处 添加 逻辑 


}); 


这 样 每 当 点 击 按钮 时 , 就 会 执行 监听 器 中 的 onCLick() 方 法 , 我 们 只 需要 在 这 个 方法 中 加 入 
待 处 理 的 逻辑 就 行 了 。 如 果 你 不 喜欢 使 用 匿名 类 的 方式 来 注册 监听 器 ,也 可 以 使 用 实现 接口 的 方 
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式 来 进行 注册 ， 代 码 如 下 所 示 : 
public class MainActivity extends AppCompatActivity impLements View.OnClickListener { 


@Override 

protected void onCreate(Bundle savedInstanceState) { 
super.onCreate(savedInstanceState); 
setContentView(R.layout.activity main); 
Button button = (Button) findViewById(R.id.button); 
button.setOnClickListener (this); 

} 


@Override 
public void onClick(View v) { 
Switch (v.getId()) { 
case R.id.button: 
// 在 此 处 添加 逻辑 
break; 
default: 
break; 


} 
这 两 种 写法 都 可 以 实现 对 按钮 点 击 事件 的 监听 ， 至 于 使 用 哪 一 种 就 全 赁 你 的 喜好 了 。 


3.2.3 EditText 


EditText 是 程序 用 于 和 用 户 进行 交互 的 另 一 个 重要 控件 ， 它 允许 用 户 在 控件 里 输入 和 编辑 内 
容 ， 并 可 以 在 程序 中 对 这 些 内 容 进行 处 理 。EditText 的 应 用 场景 非常 普遍 ， 在 进行 发 短信 、 发 微 
博 、 聊 QQ 等 操作 时 ， 你 不 得 不 使 用 EditText。 那 我 们 来 看 一 看 如 何在 界面 上 加 入 EditText 吧 ， 
修改 activity main.xml 中 的 代码 ， 如 下 所 示 : 


<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:orientation="vertical" 
android:layout width="match parent" 
android:layout height="match parent"> 


<EditText 
android:id="@+id/edit text" 
android:Tlayout width="match_parent" 
android:layout height="wrap_content" 
/> 


</LinearLayout> 


其 实 看 到 这 里 ,我 估计 你 已 经 总 结 出 Android 控件 的 使 用 规律 了 ， 用 法 基本 上 都 很 相似 : 给 
控件 定义 一 个 id， 再 指定 控件 的 宽度 和 高 度 ， 然 后 再 适当 加 入 一 些 控 件 特有 的 属性 就 差不多 了 。 


3.2 ”常用 控件 的 使 用 方法 83 


所 以 使 用 XML 来 编写 界面 其 实 一 点 都 不 难 ， 完 全 可 以 不 用 借助 任何 可 视 化 工具 来 实现 。 现 
在 重新 运行 一 下 程序 , EditText 就 已 经 在 界面 上 显示 出 来 了 , 并 且 我 们 是 可 以 在 里 面 输入 内 容 的 ， 


如 图 3.5 所 示 。 
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图 3.5 EditText 运行 效果 


细心 的 你 平时 应 该 会 留意 到 , 一 些 做 得 比较 人 性 化 的 软件 会 在 输入 框 里 显示 一 些 提 示 性 的 文 
字 ， 然 后 一 旦 用 户 输入 了 任何 内 容 ， 这 些 提 示 性 的 文字 就 会 消失 。 这 种 提示 功能 在 Android 里 是 
非常 容易 实现 的 ， 我 们 甚至 不 需要 做 任何 的 逻辑 控制 ， 因 为 系统 已 经 帮 有 我 们 都 处 理 好 了 。 修 改 
activity_ main.xml， 如 下 所 示 : 


<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:orientation="vertical" 
android:layout width="match parent" 
android:layout height="match parent"> 


<EditText 
android:id="@+id/edit text" 
android:layout width="match parent" 
android:layout height="wrap content" 
android:hint="Type something here" 
/> 


</LinearLayout> 


这 里 使 用 android:hint 属性 指定 了 一 段 提示 性 的 文本 ， 然 后 重新 运行 程序 ， 效 果 如 图 3.6 
所 示 。 
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图 3.6 EditText 设置 hint 效 果 


可 以 看 到 ，EditText 中 显示 了 一 段 提 示 性 文本 ， 然 后 当 我 们 输入 任何 内 容 时 ， 这 段 文本 就 会 
自动 消失 。 

不 过 ， 随 着 输入 的 内 容 不 断 增 多 ，EditText 会 被 不 断 地 拉 长 。 这 时 由 于 EditText 的 高 度 指定 
的 是 wrap_content ， 因 此 它 总 能 包含 住 里 面 的 内 容 ， 但 是 当 输 入 的 内 容 过 多 时 ， 界 面 就 会 变 得 
非常 难看 。 我 们 可 以 使 用 android:maxLines 属性 来 解决 这 个 问题 ， 修 改 activity main.xml， 如 
下 所 示 : 


<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:orientation="vertical" 
android:layout width="match parent" 
android:layout height="match parent"> 


<EditText 
android:id="@+id/edit text" 
android:layout width="match parent" 
android:layout height="wrap content" 
android:hint="Type something here" 
android:maxLines="2" 
/> 


</LinearLayout> 


这 里 通过 android:maxLines 指定 了 EditText 的 最 大 行 数 为 两 行 , 这 样 当 输入 的 内 容 超 过 两 
行 时 ， 文 本 就 会 向 上 滚动 ， 而 EditText 则 不 会 再 继续 拉 伸 ， 如 图 3.7 所 示 。 
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图 3.7 EditText 设 置 maxLines 效果 


我 们 还 可 以 结合 使 用 EditText 与 Button 来 完成 一 些 功能 ， 比 如 通过 点 击 按钮 来 获取 EditText 
中 输入 的 内 容 。 修 改 MainActivity 中 的 代码 ， 如 下 所 示 : 


public class MainActivity extends AppCompatActivity impLements View.OnClickListener { 
private EditText editText; 


@Override 

protected void onCreate(Bundle savedInstanceState) { 
super.onCreate(savedInstanceState); 
setContentView(R.layout.activity main); 
Button button = (Button) findViewById(R.id.button); 
editText = (EditText) findViewById(R.id.edit text); 
button.setOnClickListener(this); 

} 


@Override 
public void onClick(View v) { 
Switch (v.getId()) { 
case R.id.button: 
String inputText = editText.getText().toString() ; 
Toast .makeText (MainActivity.this, inputText, 
Toast.LENGTH_SHORT) .show() ; 
break; 
default: 
break ; 
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首先 通过 findViewById() 方 法 得 到 EditText 的 实例 ,然后 在 按钮 的 点 击 事件 里 调用 EditText 
的 getText () 方 法 获取 到 输入 的 内 容 , 再 调用 toSt ring( ) 方 法 转换 成 字符 串 ,最 后 还 是 老 方法 ， 
使 用 Toast 将 输入 的 内 容 显示 出 来 。 
重新 运行 程序 ， 在 EditText 中 输入 一 段 内 容 ， 然 后 点 击 按钮 ， 效 果 如 图 3.8 所 示 。 
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图 3.8 ”获取 EditText 中 输入 的 内 容 


3.2.4 ImageView 


ImageView 是 用 于 在 界面 上 展示 图 片 的 一 个 控件 , 它 可 以 让 我 们 的 程序 界面 变 得 更 加 丰富 多 
彩 。 学 习 这 个 控件 需要 提前 准备 好 一 些 图 片 , 图 片 通常 都 是 放 在 以 “drawable” 开 头 的 目录 下 的 。 
目前 我 们 的 项 目 中 有 一 个 空 的 drawable 目录 , 不 过 由 于 这 个 目录 没有 指定 具体 的 分 辩 率 , 所 以 一 
般 不 使 用 它 来 放置 图 片 。 这 里 我 们 在 res 目录 下 新 建 一 个 drawable-xhdpi 目录 ， 然 后 将 事先 准备 
好 的 两 张 图 片 img_1.png 和 img 2.png 复制 到 该 目录 当中 。 


接 下 来 修改 activity main.xml， 如 下 所 示 : 


<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:orientation="vertical" 
android:layout width="match parent" 
android:layout height="match parent"> 


<ImageView 
android:id="@+id/image view" 
android:1layout width="wrap_content" 
android:layout height="wrap_content" 
android:src="@drawable/img 1 " 
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/> 
</LinearLayout> 
可 以 看 到 ， 这 里 使 用 android:src 属性 给 ImageView 指定 了 一 张 图 片 。 由 于 图 片 的 宽 和 高 
都 是 未 知 的 ， 所 以 将 ImageView 的 宽 和 高 都 设 定 为 wrap_content ， 这 样 就 保证 了 不 管 图 片 的 尺 
寸 是 多 少 ， 图 片 都 可 以 完整 地 展示 出 来 。 重 新 运行 程序 ， 效 果 如 图 3.9 所 示 。 
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图 3.9 ”ImageView 运行 效果 


我 们 还 可 以 在 程序 中 通过 代码 动态 地 更 改 ImageView 中 的 图 片 , 然后 修改 MainActivity 的 代 
码 ， 如 下 所 示 : 


public class MainActivity extends AppCompatActivity implements View.OnClickListener { 


private EditText editText; 
private ImageView imageView; 


GOverride 

protected void onCreate(Bundle savedInstanceState) { 
super.onCreate(savedInstanceState); 
setContentView(R.layout.activity main); 
Button button = (Button) findViewById(R.id.button); 
editText = (EditText) findViewById(R.id.edit text); 
imageView = (ImageView) findViewById(R.id.image view); 
button.setOnClickListener(this); 

} 


@Override 
public void onClick(View v) { 
switch (v.getId()) { 
case R.id.button: 
imageView.setImageResource(R.drawable.img 2); 
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break; 
default: 
break ; 


} 


在 按钮 的 点 击 事件 里 , 通过 调用 ImageView 的 setImageResource() 方 法 将 显示 的 图 片 改 成 
img 2， 现 在 重新 运行 程序 ， 然 后 点 击 一 下 按钮 ， 就 可 以 看 到 ImageView 中 显示 的 图 片 改 变 了 ， 


如 图 3.10 所 示 。 


wa 11:13 
UIWidgetTest 


BUTTON 


本 oO 口 


图 3.10 动态 更 改 ImageView 中 的 图 片 


3.2.5 ProgressBar 
ProgressBar 用 于 在 界面 上 显示 一 个 进度 条 , 表示 我 们 的 程序 正在 加 载 一 些 数据 。 它 的 月 


非常 简单 ， 修 改 activity_main.xml 中 的 代码 ， 如 下 所 示 : 


<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:orientation="vertical" 
android:layout width="match parent" 
android:layout height="match parent"> 


<ProgressBar 
android:id="@+id/progress_bar" 
android:Tlayout width="match_parent" 
android:layout height="wrap_content" 
/> 


</LinearLayout> 


日 法 也 
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重新 运行 程序 ， 会 看 到 屏幕 中 有 一 个 圆 形 进度 条 正在 旋转 ， 如 图 3.11 所 示 。 
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aq O 品 
图 3.11 ProgressBar 运行 效果 


这 时 你 可 能 会 问 , 旋转 的 进度 条 表明 我 们 的 程序 正在 加 载 数据 , 那 数据 总 会 有 加 载 完 的 时 候 
吧 ? 如 何 才 能 让 进度 条 在 数据 加 载 完 成 时 消失 呢 ? 这 里 我 们 就 需要 用 到 一 个 新 的 知识 点 : 
Android 控件 的 可 见 属性 。 所 有 的 Android 控件 都 具有 这 个 属性 , 可 以 通过 android:visibility 
进行 指定 ， 可 选 值 有 3 种 : visible、invisible 和 gone。visible 表示 控件 是 可 见 的 ， 这 个 
值 是 默认 值 ， 不 指定 android:visibility 时 ,控件 都 是 可 见 的 。invisible 表示 控件 不 可 见 ， 
但 是 它 仍然 占据 着 原来 的 位 置 和 大 小 ， 可 以 理解 成 控件 变 成 透明 状态 了 。gone 则 表示 控件 不 仅 
不 可 见 ， 而 且 不 再 占用 任何 屏幕 空间 。 我 们 还 可 以 通过 代码 来 设置 控件 的 可 见 性 ， 使 用 的 是 
setVisibitity() 方 法 ， 可 以 传人 View.VISIBLE、View.INVISIBLE 和 View.GONE 这 3 种 值 。 

接 下 来 我 们 就 来 尝试 实现 , 点 击 一 下 按钮 让 进度 条 消失 , 再 点 击 一 下 按钮 让 进度 条 出 现 的 这 
种 效果 。 修 改 MainActivity 中 的 代码 ， 如 下 所 示 : 


public class MainActivity extends AppCompatActivity impLements View.OnClickListener { 


加 


private EditText editText 
private ImageView imageView; 
private ProgressBar progressBar; 


GOverride 

protected void onCreate(Bundle savedInstanceState) { 
super.onCreate(savedInstanceState); 
setContentView(R.layout.activity main); 
Button button = (Button) findViewById(R.id.button); 
editText = (EditText) findViewById(R.id.edit text); 
imageView = (ImageView) findViewById(R.id.image view); 
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progressBar = (ProgressBar) findViewById(R.id.progress bar); 
button.setOnClickListener(this); 
} 


@Override 
public void onClick(View v) { 
switch (v.getId()) { 
case R.id.button: 
if (progressBar.getVisibility() == View.GONE) { 
progressBar.setVisibility (View.VISIBLE); 
} else{ 
progressBar.setVisibility (View.GONE); 
} 
break; 
default: 
break ; 


} 


在 按钮 的 点 击 事件 中 ， 我 们 通过 getVisibility() 方 法 来 判断 ProgressBar 是 否 可 见 ， 如 果 
可 见 就 将 ProgressBar 隐藏 掉 ， 如 果 不 可 见 就 将 ProgressBar 显示 出 来 。 重 新 运行 程序 ， 然 后 不 断 
地 点 击 按钮 ， 你 就 会 看 到 进度 条 会 在 显示 与 隐藏 之 间 来 回 切换 。 

另外 ， 我 们 还 可 以 给 ProgressBar 指定 不 同 的 样式 ， 刚 刚 是 圆 形 进 度 条 ， 通 过 style 属性 可 
以 将 它 指定 成 水 平 进度 条 ， 修 改 activity main.xml 中 的 代码 ， 如 下 所 示 : 


<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:orientation="vertical" 
android:layout width="match parent" 
android:layout height="match parent"> 


<ProgressBar 
android:id="@+id/progress bar" 
android:layout width="match parent" 
android:layout height="wrap content" 
style="?android:attr/progressBarStyleHorizontal" 
android:max="100" 
/> 


</LinearLayout> 


指定 成 水 平 进 度 条 后 ， 我 们 还 可 以 通过 android:max 属性 给 进度 条 设置 一 个 最 大 值 ， 然 后 
在 代码 中 动态 地 更 改进 度 条 的 进度 。 修 改 MainActivity 中 的 代码 ， 如 下 所 示 : 


public class MainActivity extends AppCompatActivity implements View.0nCLickListener { 


@Override 


3.2 ”常用 控件 的 使 用 方法 91 


public void onClick(View v) { 
Switch (v.getId()) { 

case R.id.button: 
int progress = progressBar.getProgress(); 
progress = progress + 10; 
progressBar.setProgress(progress); 
break; 

default: 
break; 


上 
每 点 击 一 次 按钮 ， 我 们 就 获取 进度 条 的 当前 进度 ， 然 后 在 现 有 的 进度 上 加 10 作为 更 新 后 的 
进度 。 重 新 运行 程序 ， 点 击 数 次 按钮 后 ， 效 果 如 图 3.12 所 示 。 
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图 3.12 ”ProgressBar 水 平 样式 效果 


ProgressBar 还 有 几 种 其 他 的 样式 ， 你 可 以 自己 去 尝试 一 下 。 


3.2.6 AlertDialog 


AlertDialog 可 以 在 当前 的 界面 弹出 一 个 对 话 框 ， 这 个 对 话 框 是 置 项 于 所 有 界面 元 素 之 上 的 ， 
能 够 屏蔽 掉 其 他 控件 的 交互 能 力 ， 因 此 AlertDialog 一 般 都 是 用 于 提示 一 些 非 常 重要 的 内 容 或 者 
警告 信息 。 比 如 为 了 防止 用 户 误 删 重要 内 容 ,， 在 删除 前 弹出 一 个 确认 对 话 框 。 下 面 我 们 来 学 习 一 
下 它 的 用 法 ， 修 改 MainActivity 中 的 代码 ， 如 下 所 示 : 


public cLass MainActivity extends AppCompatActivity impLements View.OnClickListener { 


GOverride 
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public void onClick(View v) { 
Switch (v.getId()) { 
case R.id.button: 

AlertDialog.Builder dialog = new AlertDialog.Builder (MainActivity. 
this); 

dialog.setTitle("This is Dialog"); 

dialog.setMessage("Something important."); 

dialog.setCancelable (false); 

dialog.setPositiveButton("0K", new DialogInterface. 
OnClickListener() { 
@Override 
public void onCLick(DiaLogInterface dialog, int which) { 
} 

}); 

dialog.setNegativeButton("Cancel", new DialogInterface. 
OnClickListener() { 
@Override 
public void onCLick(DiaLogInterface dialog, int which) { 
} 

}); 

dialog. show(); 

break; 

default: 
break; 


} 


首先 通过 AlertDialog.Builder 创建 一 个 AlertDialog 的 实例 ,然后 可 以 为 这 个 对 话 框 设 置 标题 、 
内 容 、 可 否 用 Back 键 关闭 对 话 框 等 属性 , 接 下 来 调用 setPositiveButton() 方 法 为 对 话 框 设置 
确定 按钮 的 点 击 事件 ， 调 用 setNegativeButton() 方 法 设置 取消 按钮 的 点 击 事件 ， 最 后 调用 
show() 方 法 将 对 话 框 显示 出 来 。 重 新 运行 程序 ， 点 击 按钮 后 ， 效 果 如 图 3.13 所 示 。 


This is Dialog 


Something important 


图 3.13 ”AlertDialog 运行 效果 
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3.2.7 ProgressDialog 


ProgressDialog 和 AlertDialog 有 点 类 似 ， 都 可 以 在 界面 上 弹出 一 个 对 话 框 ， 都 能 够 屏蔽 掉 其 
他 控件 的 交互 能 力 。 不 同 的 是 ，ProgressDialog 会 在 对 话 框 中 显示 一 个 进度 条 ， 一般 用 于 表示 当 
前 操作 比较 耗 时 ， 让 用 户 耐 心地 等 待 。 它 的 用 法 和 AlertDialog 也 比较 相似 ,修改 MainActivity 
中 的 代码 ， 如 下 所 示 : 


public class MainActivity extends AppCompatActivity impLements View.OnClickListener { 


@Override 
public void onClick(View v) { 
Switch (v.getId()) { 
case R.id.button: 
ProgressDialog progressDialog = new ProgressDialog 
(MainActivity .this); 
progressDialog.setTitle("This is ProgressDialog"); 
progressDialog.setMessage("Loading..."); 
progressDialog.setCancelable(true); 
progressDialog.show(); 
break; 
default: 
break; 


上 

可 以 看 到 ， 这 里 也 是 先 构 建 出 一 个 ProgressDialog 对 象 ， 然 后 同样 可 以 设置 标题 、 内 容 、 
可 否 取 消 等 属性 , 最 后 也 是 通过 调用 show( ) 方 法 将 ProgressDialog 显示 出 来 。 重新 运行 程序 ， 点 
击 按钮 后 ， 效 果 如 网 3.14 所 示 。 


This is ProgressDialog 


\) ading 


图 3.14 ”ProgressDialog 运行 效果 
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注意 ， 如 果 在 setCancelable() 中 传人 了 faLse， 表 示 ProgressDialog 是 不 能 通过 Back 键 
取消 掉 的 ， 这 时 你 就 一 定 要 在 代码 中 做 好 控制 ， 当 数据 加 载 完 成 后 必须 要 调用 ProgressDialog 的 
dismiss() 方 法 来 关闭 对 话 框 ， 否 则 ProgressDialog 将 会 一 直 存 在 。 

好 了 ,关于 Android 常用 控件 的 使 用 ， 我 要 讲 的 就 具有 这 么 多 。 一 节 内 容 就 想 覆 盖 Android 
控件 所 有 的 相关 知识 不 太 现实 ， 同 样 一 口气 就 想 学 会 所 有 Android 控件 的 使 用 方法 也 不 太 现实 。 
本 节 所 讲 的 内 容 对 于 你 来 说 只 是 起 到 了 一 个 引导 的 作用 ， 你 还 需要 在 以 后 的 学 习 和 工作 中 不 断 
地 摸索 , 通过 查阅 文档 以 及 网 上 搜索 的 方式 学 习 更 多 控件 的 更 多 用 法 。 当 然 ， 当 本 书后 面 涉 及 一 
些 我 们 前 面 没 学 过 的 控件 和 相关 用 法 时 ， 我 仍然 会 在 相应 的 章节 做 详细 的 讲解 。 


3.3 详解 4 种 基本 布局 


一 个 丰富 的 界面 总 是 要 由 很 多 个 控件 组 成 的 , 那 我 们 如 何 才能 让 各 个 控件 都 有 条 不 率 地 摆 放 
在 界面 上 ,而 不 是 乱 精 精 的 呢 ? 这 就 需要 借助 布局 来 实现 了 。 布局 是 一 种 可 用 于 放置 很 多 控件 的 
容器 ,， 它 可 以 按照 一 定 的 规律 调整 内 部 控件 的 位 置 ， 从 而 编写 出 精美 的 界面 。 当 然 , 布局 的 内 部 
除了 放置 控件 外 ,也 可 以 放置 布局 , 通过 多 层 布 局 的 骨 套 , 我 们 就 能 够 完成 一 些 比较 复杂 的 界面 
实现 ， 图 3.15 很 好 地 展示 了 它们 之 间 的 关系 。 
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图 3.15 布局 和 控件 的 关系 


下 面 我 们 来 详细 讲解 下 Android 中 4 种 最 基本 的 布局 。 先 做 好 准备 工作 ， 新 建 一 个 
UILayoutTest 项目， 并 让 Android Studio 自动 带 我 们 创建 好 活动 ,活动 名 和 布局 名 都 使 用 默认 值 。 


3.3.1 线性 布局 


LinearLayout 又 称 作 线性 布局 ， 是 一 种 非常 常用 的 布局 。 正 如 它 的 名 字 所 描述 的 一 样 ， 这 个 
布局 会 将 它 所 包含 的 控件 在 线性 方向 上 依次 排列 。 相 信 你 之 前 也 已 经 注意 到 了 , 我 们 在 上 一 节 中 
学 习 控件 用 法 时 ， 所 有 的 控件 就 都 是 放 在 LinearLayout 布局 里 的 ， 因 此 上 一 节 中 的 控件 也 确实 是 
在 垂直 方向 上 线性 排列 的 。 


既然 是 线性 排列 ,肯定 就 不 仅 只 有 一 个 方向 , 那 为 什么 上 一 节 中 的 控件 都 是 在 垂直 方向 排列 
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的 呢 ? 这 是 由 于 我 们 通过 android:orientation 


属性 指定 了 排列 方向 是 vertical , 如 果 指 定 的 是 


horizontal, 控件 就 会 在 水 平方 向 上 排列 了 。 下 面 我 们 通过 实战 来 体会 一 下 , 修改 activity_main.xml 


中 的 代码 ， 如 下 所 示 : 


<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 


android:orientation="vertical" 
android:layout width="match parent" 


android:layout height="match parent"> 


<Button 
android:id="@+id/buttonl" 


android:layout width="wrap_content" 
android:layout height="wrap content" 


android:text="Button 1" /> 


<Button 
android:id="@+id/button2" 


android:layout width="wrap_content" 
android:layout height="wrap_ content" 


android:text="Button 2" /> 


<Button 
android:id="@+id/button3" 


android:layout width="wrap_ content" 
android:layout height="wrap content" 


android:text="Button 3" /> 


</LinearLayout> 


我 们 在 LinearLayout 中 添加 了 3 个 Button， 每 个 Button 的 长 和 宽 都 是 wrap_content， 并 指 


定 了 排列 方向 是 vertical。 现 在 运行 一 下 程序 ， 效 果 如 图 3.16 所 示 。 
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图 3.16 LinearLayout 


垂直 排列 
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然后 我 们 修改 一 下 LinearLayout 的 排列 方向 ， 如 下 所 示 : 


<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:orientation="horizontal" 
android:layout width="match parent" 
android:layout height="match parent"> 


</LinearLayout> 

将 android:orientation 属性 的 值 改 成 了 horizontal, 这 就 意味 着 要 让 LinearLayout 中 的 控 
件 在 水 平方 向 上 依次 排列 。 当 人 然 如 果 不 指定 android:orientation 属性 的 值 ， 默 认 的 排列 方向 
就 是 horizontal。 重 新 运行 一 下 程序 ， 效 果 如 图 3.17 所 示 。 
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图 3.17 LinearLayout 水平 排列 


这 里 需要 注意 ， 如 果 LinearLayonut 的 排列 方向 是 horizontal， 内 部 的 控件 就 绝对 不 能 将 宽度 
指定 为 match_parent ， 因 为 这 样 的 话 ， 单 独 一 个 控件 就 会 将 整个 水 平方 向 占 满 ， 其 他 的 控件 就 
没有 可 放置 的 位 置 了 。 同 样 的 道理 , 如果 LinearLayout 的 排列 方向 是 vertical， 内 部 的 控件 就 不 能 
将 高 度 指 定 为 match_parent。 
首先 来 看 android:Layout_gravity 属性 ， 它 和 我 们 上 一 节 中 学 到 的 android:gravity 
属性 看 起 来 有 些 相 似 ， 这 两 个 属性 有 什么 区 别 呢 ? 其 实 从 名 字 就 可 以 看 出 ，android:gravity 
用 于 指定 文字 在 控件 中 的 对 齐 方式 ， 而 android:tLayout gravity 用 于 指定 控件 在 布局 中 的 对 
齐 方式 。android:Layout gravity 的 可 选 值 和 android:gravity 差不多 , 但 是 需要 注意 ， 当 
LinearLayout 的 排列 方向 是 horizontal 时 ,只 有 垂直 方向 上 的 对 齐 方式 才 会 生效 , 因为 此 时 水 平方 
向 上 的 长 度 是 不 固定 的 , 每 添加 一 个 控件 ,水 平方 向 上 的 长 度 都 会 改变 ， 因而 无 法 指定 该 方向 上 
的 对 齐 方式 。 同 样 的 道理 ， 当 LinearLayout 的 排列 方向 是 vertical 时 ， 只 有 水 平方 向 上 的 对 齐 方 
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式 才 会 生效 。 修 改 activity_ main.xml 中 的 代码 ， 如 下 所 示 : 


<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:orientation="horizontal" 
android:layout width="match parent" 
android:layout height="match parent"> 


<Button 
android:id="@+id/buttonl" 
android:layout width="wrap_ content" 
android:layout height="wrap content" 
android:layout gravity="top" 
android:text="Button 1" /> 


<Button 
android:id="@+id/button2" 
android:layout width="wrap_ content" 
android:layout height="wrap_ content" 
android:1layout gravity="center vertical" 
android:text="Button 2" /> 


<Button 
android:id="@+id/button3" 
android:layout width="wrap content" 
android:layout height="wrap content" 
android:layout gravity="bottom" 
android:text="Button 3" /> 


</LinearLayout> 


由 于 目前 LinearLayout 的 排列 方向 是 horizontal， 因 此 我 们 只 能 指定 垂直 方向 上 的 排列 


将 第 一 个 Button 的 对 齐 方式 指定 为 top， 第 二 个 Button 的 对 齐 方式 指定 为 center vertical， 委 


方向 ， 


用 一 个 


Button 的 对 齐 方式 指定 为 bottom。 重 新 运行 程序 ， 效 果 如 图 3.18 所 示 。 
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图 3.18 指定 layout gravity 的 效果 


> 一 ~ 
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接 下 来 我 们 学 习 下 LinearLayout 中 的 另 一 个 重要 属 必 
属性 允许 我 们 使 用 比例 的 方式 来 指定 控件 的 大 小 , 它 在 手机 屏幕 的 适 配 性 方面 可 以 起 到 非常 重要 


一 一 android:Layout weight。 这 个 


的 作用 。 比 如 我 们 正在 编写 一 个 消息 发 送 界面 ， 需 要 一 个 文本 编辑 框 和 一 个 发 送 按钮 ， 修 改 
activity_ main.xml 中 的 代码 ， 如 下 所 示 : 


<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:orientation="horizontal" 
android:layout width="match parent" 
android:layout height="match parent"> 


<EditText 


android: 
android: 
android: 
android: 
android: 


/> 


<Button 


android: 
android: 
android: 
android: 
android: 


/> 


</LinearLayout> 


id="@+id/input_message" 
layout width="Qdp" 
layout_height="wrap_content" 
layout weight="1" 

hint="Type something" 


id="@+id/send" 

layout width="Qdp" 

layout_ height="wrap_content" 
layout weight="1" 
text="Send" 


你 会 发 现 ， 这 里 竟然 将 EditText 和 Button 的 宽度 都 指定 成 了 0dp， 这样 文 本 编辑 框 和 按钮 还 
能 显示 出 来 吗 ? 不 用 担心 , 由 于 我 们 使 用 了 android:layout weight 属性 ， 此 时 控件 的 宽度 就 
不 应 该 再 由 android:tLayout_width 来 决定 ， 这 里 指定 成 0dp 是 一 种 比较 规范 的 写法 。 另 外 ， 


dp 是 Android 中 用 于 指定 控件 大 小 、 间 距 等 
然后 在 EditText 和 Button 里 都 将 android:layout weight 属 怕 


EditText 和 Button 将 在 水 平方 向 平分 宽度 。 

为 什么 将 android:Layout_weight 属性 的 值 同 时 指定 为 1 就 会 平分 
也 很 简单 ,系统 会 先 把 LinearLayout 下 所 有 控件 指定 的 Llayout_weight 值 相 加 , 得 到 一 个 总 值 ， 
然后 每 个 控件 所 占 大 小 的 比例 就 是 用 该 控件 的 Layout_weight 值 除 以 刚才 算出 的 总 值 。 因 此 如 
果 想 让 EditText 占据 屏幕 宽度 的 35，Button 占据 屏幕 宽度 的 25， 只 需要 将 EditText 的 Layout_ 
weight 改 成 3，Button 的 Layout_weight 改 成 2 就 可 以 了 。 


重新 运行 程序 ， 你 会 看 到 如 图 3.19 所 示 的 效果 。 


属性 的 单位 ， 后 面 我 们 还 会 经 常用 到 它 。 
的 值 指定 为 1， 这 表示 


翌 幕 宽度 呢 ? 其 实 原理 
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Jrype something SEND 


4 O 〇 口 


图 3.19 指定 Layout_weight 的 效果 


我 们 还 可 以 通过 指定 部 分 控件 的 Layout_weight 值 来 实现 更 好 的 效果 。 修 改 activity_main. 
xml 中 的 代码 ， 如 下 所 示 : 


<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:orientation="horizontal" 
android:layout width="match parent" 
android:layout height="match parent"> 


<EditText 
android:id="@+id/input message" 
android:layout width="Qdp" 
android:layout height="wrap content" 
android:layout weight="1" 
android:hint="Type something" 
/> 


<Button 
android:id="@+id/send" 
android:Tlayout width="wrap_content" 
android:layout height="wrap content" 
android:text="Send" 
/> 


</LinearLayout> 


这 里 我 们 仅 指 定 了 EditText 的 android:Layout weight 属性 ， 并 将 Button 的 宽度 改 回 
wrap_content。 这 表示 Button 的 宽度 仍然 按照 wrap_content 来 计算 ， 而 EditText 则 会 占 满 屏 
幕 所 有 的 剩余 空间 。 使 用 这 种 方式 编写 的 界面 , 不 仅 在 各 种 屏幕 的 适 配 方面 会 非常 好 ， 而 且 看 起 
来 也 更 加 和 舒服。 重新 运行 程序 ， 效 果 如 图 3.20 所 示 。 
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图 3.20 使 用 Layout weight 实现 宽度 自 适 配 效 果 
3.3.2 ”相对 布局 


RelativeLayout 又 称 作 相对 布局 ， 也 是 一 种 非常 常用 的 布局 。 和 LinearLayout 的 排列 规则 不 
同 ，RelativeLayout 显得 更 加 随意 一 些 ， 它 可 以 通过 相对 定位 的 方式 让 控件 出 现在 布局 的 任何 位 
置 。 也 正 因为 如 此 ，RelativeLayout 中 的 属性 非常 多 ， 不 过 这 些 属性 都 是 有 规律 可 循 的 ， 其 实 并 


不 难怪 


E 解 和 记忆 。 我 们 还 是 通过 实践 来 体会 一 下 ， 修 改 activity_main.xml 中 的 代码 ， 如 下 所 示 : 


<RelativeLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:layout width="match parent" 
android:layout height="match parent"> 


<Button 


android: 
android: 
android: 
:layout alignParentLeft="true" 
android: 
android: 


android 


<Button 


android: 
android: 
android: 
android: 
android: 
android: 


<Button 


android: 
android: 


id="@+id/buttonl" 
layout width="wrap content" 
layout height="wrap content" 


layout alignParentTop="true" 
text="Button 1" /> 


id="@+id/button2" 

layout width="wrap content" 
layout height="wrap content" 
layout alignParentRight="true" 
layout alignParentTop="true" 
text="Button 2" /> 


id="@+id/button3" 
layout width="wrap content" 
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<Button 


android : 
android: 
android: 
:layout alignParentBottom="true" 
android: 
android: 


android 


<Button 


android: 
android: 
android: 
android: 
:layout alignParentRight="true" 
android: 


android 


:layout height="wrap content" 
android: 
android: 


layout centerInParent="true" 
text="Button 3" /> 


id="@+id/button4" 
layout width="wrap content" 
layout height="wrap content" 


layout alignParentLeft="true" 
text="Button 4" /> 


id="@+id/button5" 

layout width="wrap_ content" 
layout height="wrap content" 
layout alignParentBottom="true" 


text="Button 5" /> 


</RelativeLayout> 


我 想 以 上 代码 已 经 不 需要 我 8 


有 做 过 多 解释 了， 因为 实在 是 太 好 理解 了 。 我们 让 Button 1 和 父 


布局 的 左上 角 对 齐 ，Button 2 和 父 布局 的 右上 角 对 齐 ，Button 3 居中 显示 ，Button 4 和 父 布局 的 左 
下 角 对 齐 ，Button 5 和 父 布 局 的 右 下 角 对 齐 。 虽 然 android:layout alignParentLeft、 
android:layout _aLignParentTop .android:Layout alignParentRight android:Layout 
android:Layout_centerInParent 这 几 个 属性 我 们 之 前 都 没 接触 过 ， 
可 是 它们 的 名 字 已 经 完全 说 明了 它们 的 作用 。 重 新 运行 程序 ， 效 果 如 图 3.21 所 示 。 


alignParentBottom.、 
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BUTTONT1 BUTTON2 


BUTTON3 


BUTTON 4 BUTTONS 


图 3.21 相对 于 父 布局 定位 的 效果 


A 太 
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上 面 例子 中 的 每 个 控件 都 是 相对 于 父 布局 进行 定位 的 , 那 控 件 可 不 可 以 相对 于 控件 进行 定位 
呢 ? 当然 是 可 以 的 ， 修 改 activity_main.xml 中 的 代码 ， 如 下 所 示 : 


<RelativeLayout xmlns:android="http://schemas.android 
android:layout width="match parent" 
android:layout height="match parent"> 


<Button 
android: 
android: 
android: 
android: 
android: 


id="@+id/button3" 

layout width="wrap_content" 
layout height="wrap content" 
layout centerInParent="true" 
text="Button 3" /> 


<Button 
android: 
android: 
android: 
android: 
android: 
android: 


id="@+id/button1" 

layout width="wrap_content" 
layout height="wrap_ content" 
layout_above="@id/button3" 
layout toLeft0f="@id/button3" 
text="Button 1" /> 


<Button 
android: 
android: 
android: 
android: 
android: 
android: 


id="@+id/button2" 

layout width="wrap_content" 
layout height="wrap content" 
layout above="@id/button3" 
layout toRight0f="@id/button3" 
text="Button 2" /> 


<Button 
android: 
android: 
android: 
android: 
android: 
android: 


id="@+id/button4" 

layout width="wrap content" 
layout height="wrap_content" 
layout_ below="@id/button3" 
layout toLeft0f="@id/button3" 
text="Button 4" /> 


<Button 
android: 
android: 
android: 
android: 
android: 
android: 


id="@+id/button5" 

layout width="wrap_content" 
layout height="wrap content" 
layout below="@id/button3" 
layout toRight0f="@id/button3" 
text="Button 5" /> 


</RelativeLayout> 


.Com/apk/res/android" 


这 次 的 代码 稍微 复杂 一 点 , 不 过 仍然 是 有 规律 可 循 的 。android:Layout_above 属性 可 以 让 
一 个 控件 位 于 另 一 个 控件 的 上 方 ， 需 要 为 这 个 属性 指定 相对 控件 id 的 引用 ， 这 里 我 们 填 人 了 


@id/button3， 表 示 让 该 控件 位 于 Button 3 的 上 方 。 其 他 的 


属性 也 都 是 相似 的 ，android: 


layout_below 表示 让 一 个 控件 位 于 男 一 个 控件 的 下 方 ，android:1layout_toLeft0f 表示 让 一 
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个 控件 位 于 另 一 个 控件 的 左 侧 ，android:Layout toRight0f 表示 让 一 个 控件 位 于 另 一 个 控件 
的 右 侧 。 注 意 ， 当 一 个 控件 去 引用 男 一 个 控件 的 id 时 ， 该 控件 一 定 要 定义 在 引用 控件 的 后 面 ， 
不 然 会 出 现 找 不 到 id 的 情况 。 重 新 运行 程序 ， 效 果 如 图 3.22 所 示 。 


i 1:33 


UlLayoutTest 


BUTTON1 BUTTON 2 
BUTTON 3 


BUTTON4 BUTTON 5 


图 3.22 ”相对 于 控件 定位 的 效果 


RelativeLayout 中 还 有 另外 一 组 相对 于 控件 进行 定位 的 属性 ，android:1layout _alignLeft 
表示 让 一 个 控件 的 左边 缘 和 另 一 个 控件 的 左边 缘 对 齐 , android:layout_alignRight 表示 让 一 
个 控件 的 右边 缘 和 另 一 个 控件 的 右边 缘 对 齐 。 此 外 ,， 还 有 android:layout alignTop 和 
android:Layout_aLignBottom, 道理 都 是 一 样 的 , 我 就 不 再 多 说 , 这 几 个 属性 就 留 给 你 自己 去 
尝试 吧 。 

好 了 ， 正 如 我 前 面 所 说 ，RelativeLayout 中 的 属性 虽然 多 ,但 都 是 有 规律 可 循 的 ， 所 以 学 起 
来 一 点 都 不 觉得 吃力 吧 ? 


3.3.3” 帧 布局 


FrameLayout 义 称 作 帧 布局 ， 它 相 比 于 前 面 两 种 布局 就 简单 太 多 了 ， 因 此 它 的 应 用 场景 也 少 
了 很 多 。 这 种 布局 没有 方便 的 定位 方式 ， 所 有 的 控件 都 会 默认 摆 放 在 布局 的 左上 角 。 让 我 们 通过 
例子 来 看 一 看 吧 ， 修 改 activity_main.xml 中 的 代码 ， 如 下 所 示 : 

<FrameLayout xmlns:android="http://schemas.android.com/apk/res/android" 


android:layout width="match parent" 
android:layout height="match parent"> 


<TextView 
android:id="@+id/text view" 
android:Layout width="wrap_ content" 
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android:layout height="wrap content" 
android:text="This is TextView" 
/> 


<ImageView 
android:id="@+id/image view" 
android:layout width="wrap content" 
android:layout height="wrap content" 
android:src="@mipmap/ic launcher" 
/> 


</FrameLayout> 


FrameLayout 中 只 是 放置 了 一 个 TextView 和 一 个 ImageView。 需 要 注意 的 是 ， 当 前 项 目 我 们 
a Ee 文 里 ImageView 直接 使 用 了 @mipmap 来 访问 ic launohet 这 这 张 图 ， 虽 说 
这 种 用 法 的 场景 6 常 少 ， 但 我 还 是 要 告诉 你 ， 这 是 完全 可 行 的。 重新 运行 程序 ， 效 果 如 图 


3.23 所 示 。 


F extV 


图 3.23 FrameLayout 运行 效果 


可 以 看 到 , 文字 和 图 片 都 是 位 于 布局 的 左上 角 。 由 于 ImageView 是 在 TextView 之 后 添加 的 ， 
因此 图 片 压 在 了 文字 的 上 面 。 
当然 除了 这 种 默认 效果 之 外 ,我 们 还 可 以 使 用 Layout_gravity 属性 来 指定 控件 在 布局 中 的 
对 齐 方式 ， 这 和 LinearLayout 中 的 用 法 是 相似 的 。 修 改 activity_main.xml 中 的 代码 ， 如 下 所 示 : 


<FrameLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:layout width="match parent" 
android:layout height="match parent"> 


<TextView 
android:id="@+id/text view" 
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android:layout width="wrap_content" 
android:layout height="wrap content" 
android:layout gravity="left" 
android:text="This is TextView" 

/> 


<ImageView 
android:id="@+id/button" 
android:layout width="wrap content" 
android:layout height="wrap_ content" 
android:1layout gravity="right" 
android:src="@mipmap/ic launcher" 
/> 


</FrameLayout> 


我 们 指定 TextView 在 FrameLayout 中 居 左 对 齐 ,指定 ImageView 在 FrameLayout 中 居 右 对 齐 ， 
然后 重新 运行 程序 ， 效 果 如 图 3.24 所 示 。 


5 中 518 
UILayoutTest 


图 3.24 指定 Layout gravity 的 效果 


总 体 来 讲 ，FrameLayout 由 于 定位 方式 的 欠缺 ， 导 致 它 的 应 用 场景 也 比较 少 ， 不 过 在 下 一 章 
中 介绍 碎片 的 时 候 我 们 还 是 可 以 用 到 它 的 。 


3.3.4 百分比 布局 


前 面 介绍 的 3 种 布局 都 是 从 Android 1.0 版 本 中 就 开始 支持 了 ， 一 直 沿 用 到 现在 ， 可 以 说 是 
满足 了 绝 大 多 数 场 景 的 界面 设计 需求 。 不 过 细心 的 你 会 发 现 ， 只 有 LinearLayout 支持 使 用 
Layout_weight 属性 来 实现 按 比例 指定 控件 大 小 的 功能 ， 其 他 两 种 布局 都 不 支持 。 比 如 说 ， 如 
果 想 用 RelativeLayout 来 实现 让 两 个 按钮 平分 布局 宽度 的 效果 ， 则 是 比较 困难 的 。 


106 第 3 章 ”软件 也 要 拼 脸蛋 一 一 UI 开发 的 点 点 滴 滴 


为 此 ，Android 引入 了 一 种 全 新 的 布局 方式 来 解决 此 问题 


百分比 布局 。 在 这 种 布局 中 ， 


我 们 可 以 不 再 使 用 wrap_content、match_parent 等 方式 来 指定 控件 的 大 小 , 而 是 允许 直接 指 
定 控件 在 布局 中 所 占 的 百分比 ， 这 样 的 话 就 可 以 轻松 实现 平分 布局 甚至 是 任意 比例 分 割 布局 的 


效果 了 。 
由 于 LinearLayout 本 身 已 经 支持 按 比例 指定 控件 的 大 小 了 ， 因 此 百分比 布局 只 为 


Frame- 


Layout 和 RelativeLayout 进行 了 功能 扩展 ， 提 供 了 PercentFrameLayout 和 PercentRelativeLayout 


这 两 个 全 新 的 布局 ， 下 面 我 们 就 来 具体 学 习 一 下 。 
不 同 于 前 3 种 布局 , 百分比 布局 属于 新 增 布局 ,那么 怎么 才能 做 到 让 新 增 布局 在 所 有 


Android 


版 本 上 都 能 使 用 呢 ? 为 此 ,Android 团队 将 百分比 布局 定义 在 了 support 库 当 中 , 我 们 只 需要 在 项 
目的 build.gradle 中 添加 百分比 布局 库 的 依赖 , 就 能 保证 百分比 布局 在 Android 所 有 系统 版 本 上 的 


兼容 性 了 。 
打开 app/build.gradle 文件 ， 在 dependencies 闭 包 中 添加 如 下 内 容 : 


dependencies { 
compile fileTree(dir: 'libs', include: ['*.jar']) 
compile 'com.android,.support:appcompat-v7:24.2.1" 
compile 'com.android.support:percent:24.2.1' 
testCompile 'junit:junit:4.12'" 


} 


需要 注意 的 是 ， 每 当 修 改 了 任何 gradle 文件 时 ，Android Studio 都 会 弹出 一 个 如 图 3.25 所 


示 的 提示 。 


| Gradle files have changed since last project sync. A project sync may be necessary for the IDE to work properly. Sync Now 


图 3.25 ”gradle 文件 修改 后 的 提示 


这 个 提示 告诉 我 们 ，gradle 文件 自 上 次 同步 之 后 又 发 生 了 变化 ， 需 要 再 次 同步 才能 使 项 目 正 
常 工作 。 这 里 只 需要 点 击 Sync Now 就 可 以 了 ， 然 后 gradle 会 开始 进行 同步 ， 把 我 们 新 添加 的 百 


分 比 布局 库 引 入 到 项 目 当中 。 
接 下 来 修改 activity_main.xml 中 的 代码 ， 如 下 所 示 : 


<android.support.percent.PercentFrameLayout 
xmlns:android="http://schemas.android.com/apk/res/android" 
xmlns:app="http://schemas.android.com/apk/res-auto" 
android:layout width="match parent" 
android:layout height="match parent"> 


<Button 
android:id="@+id/buttonl" 
android:text="Button 1" 
android:Layout gravity="left|top" 
app: layout widthPercent="50%" 
app:layout heightPercent="50%" 
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/> 


<Button 
android:id="@+id/button2" 
android:text="Button 2" 
android:Layout gravity="right|top" 
app: layout widthPercent="50%" 
app: layout heightPercent="50%" 
/> 


<Button 
android:id="@+id/button3" 
android:text="Button 3" 
android:Layout gravity="left|bottom" 
app: layout widthPercent="50%" 
app:layout heightPercent="50%" 
/> 


<Button 
android:id="@+id/button4" 
android:text="Button 4" 
android:layout gravity="right|bottom" 
app: layout widthPercent="50%" 
app:layout heightPercent="50%" 
/> 


</android.support.percent.PercentFrameLayout> 


最 外 层 我 们 使 用 了 PercentFrameLayout, 由 于 百分比 布局 并 不 是 内 置 在 系统 SDK 当中 的 , 所 
以 需要 把 完整 的 包 路 径 写 出 来 。 然 后 还 必须 定义 一 个 app 的 命名 空间 ， 这样 才能 使 用 百分比 布局 
的 自 定 义 属 性 。 

在 PercentFrameLayout 中 我 们 定义 了 4 个 按钮 ,使 用 app:Layout widthPercent 属性 将 各 
按钮 的 宽度 指定 为 布局 的 50%， 使 用 app:tLayout_heightPercent 属性 将 各 按钮 的 高 度 指定 为 
布局 的 50%。 这 里 之 所 以 能 使 用 app 前 级 的 属性 就 是 因为 刚才 定义 了 app 的 命名 空间 ， 当 然 我 们 
一 直 能 使 用 android 前 级 的 属性 也 是 同样 的 道理 。 

不 过 PercentFrameLayout 还 是 会 继承 FrameLayout 的 特性 ， 即 所 有 的 控件 默认 都 是 摆 放 在 布 
局 的 左上 角 。 那 么 为 了 让 这 4 个 按钮 不 会 重 芭 ,这 里 还 是 借助 了 Layout_gravity 来 分 别 将 这 4 
个 按钮 放置 在 布局 的 左上 、 右 上 、 左 下 、 右 下 4 个 位 置 。 

现在 我 们 已 经 可 以 重新 运行 程序 了 ， 不 过 如 果 你 使 用 的 是 老 版 本 的 Android Studio， 可 能 会 
在 activity_main.xml 中 看 到 一 些 如 图 3.26 所 示 的 错误 提示 。 


"layout_height' atitribute should be defined more... (Ctr|+F1) | 
[layout_width’ attribute should be defined more... (Ctr|+F1) | 


图 3.26 ”activity_main.xml 中 错误 提示 
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这 是 因为 老 版 本 的 Android Studio 中 内 置 了 布局 的 检查 机 制 ， 认 为 每 一 个 控件 都 应 该 通过 
android:Layout width 和 android:Layout_height 属性 指定 宽 高 才 是 合法 的 。 而 其 实 我 们 是 
通过 app:tLayout widthPercent 和 app:layout heightPercent 属性 来 指定 宽 高 的 ， 所 以 
Android Studio 没 检测 到 。 不 过 这 个 错误 提示 并 不 影响 程序 运行 ， 我 们 直接 忽视 就 可 以 了 。 当 然 
最 新 的 Android Studio 2.2 版 本 中 已 经 修复 了 这 个 问题 ， 因 此 你 可 能 并 不 会 看 到 上 述 的 错误 提示 。 


现在 重新 运行 程序 ， 效 果 如 图 3.27 所 示 。 
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图 3.27 ”PercentFrameLayout 运行 效果 


可 以 看 到 , 每 一 个 按钮 的 宽 和 高 都 占据 了 布局 的 50%, 这 样 我 们 就 轻松 实现 了 4 个 按钮 平分 
屏幕 的 效果 。 

PercentFrameLayout 的 用 法 就 介绍 到 这 里 ， 另 外 一 个 PercentRelativeLayout 的 用 法 也 是 非 
常 相 似 的 , 它 继承 了 RelativeLayout 中 的 所 有 属性 ,并 且 可 以 使 用 app:layout widthPercent 
和 app:layout_heightPercent 来 按 百分比 指定 控件 的 宽 高 ， 相 信 聪 明 的 你 一 定 可 以 举 一 反 
三 了 [eo] 

这 样 我 们 就 把 最 常用 的 几 种 布局 都 讲解 完了 ， 其 实 Android 中 还 有 AbsoluteLayout、 
TableLayout 等 布局 ， 不 过 由 于 使 用 得 实在 是 太 少 了 ， 就 不 在 本 书 中 进行 讲解 了 。 


3.4 ”系统 控件 不 够 用 ? 创建 自 定 义 控 件 


在 前 面 两 节 我 们 已 经 学 习 了 Android 中 的 一 些 常 用 控件 以 及 基本 布局 的 用 法 , 不 过 当时 我 们 
并 没有 关注 这 些 控 件 和 布局 的 继承 结构 ， 现 在 是 时 候 来 看 一 下 了 ， 如 图 3.28 所 示 。 
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| TextView | [imageView| [ViewGroup| 
不 


EditText Button LinearLayout| IRelativeLayout| | ..... 


图 3.28 常用 控件 和 布局 的 继承 结构 


可 以 看 到 ， 我 们 所 用 的 所 有 控件 都 是 直接 或 间接 继承 自 View 的 ， 所 用 的 所 有 布局 都 是 直接 
或 间接 继承 自 ViewGroup 的 。View 是 Android 中 最 基本 的 一 种 UI 组 件 ， 它 可 以 在 屏幕 上 绘制 一 
块 矩 形 区 域 ， 并 能 响应 这 块 区 域 的 各 种 事件 ， 因 此 ， 我 们 使 用 的 各 种 控件 其 实 就 是 在 View 的 基 
础 之 上 又 添加 了 各 自 特有 的 功能 。 而 ViewGroup 则 是 一 种 特殊 的 View， 它 可 以 包含 很 多 子 View 
和 子 ViewGroup， 是 一 个 用 于 放置 控件 和 布局 的 容器 。 

这 个 时 候 我 们 就 可 以 思考 一 下 ， 当 系统 自 带 的 控件 并 不 能 满足 我 们 的 需求 时 , 可 不 可 以 利用 
上 面 的 继承 结构 来 创建 自 定义 控件 呢 ? 答案 是 肯定 的 , 下面 我 们 就 来 学 习 一 下 创建 自 定义 控件 的 
两 种 简单 方法 。 先 将 准备 工作 做 好 ， 创 建 一 个 UICustomViews 项 目 。 


3.4.1 引入 布局 


如 果 你 用 过 iPhone 应 该 会 知道 ， 几 乎 每 一 个 iPhone 应 用 的 界面 顶部 都 会 有 一 个 标题 栏 ， 标 
题 栏 上 会 有 一 到 两 个 按钮 可 用 于 返回 或 其 他 操作 ( iPhone 没有 实体 返回 键 ) 现在 很 多 Android 
程序 也 都 喜欢 模仿 iPhone 的 风格 , 在 界面 的 顶部 放置 一 个 标题 栏 。 虽 然 Android 系统 已 经 给 每 个 
活动 提供 了 标题 栏 功能 ， 但 这 里 我 们 决定 先 不 使 用 它 ， 而 是 创建 一 个 自 定义 的 标题 栏 。 

经 过 前 面 两 节 的 学 习 , 相信 创建 一 个 标题 栏 布局 对 你 来 说 已 经 不 是 什么 困难 的 事情 了 ,只 需 
要 加 入 两 个 Button 和 一 个 TextView， 然 后 在 布局 中 摆 放 好 就 可 以 了 。 可 是 这 样 做 却 存在 着 一 个 
问题 , 一 般 我 们 的 程序 中 可 能 有 很 多 个 活动 都 需要 这 样 的 标题 栏 , 如 果 在 每 个 活动 的 布局 中 都 纺 
写 一 遍 同 样 的 标题 栏 代码 ,明显 就 会 导致 代码 的 大 量 重复 。 这 个 时 候 我 们 就 可 以 使 用 引入 布局 的 
方式 来 解决 这 个 问题 ， 新 建 一 个 布局 titlexml， 代 码 如 下 所 示 : 


<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:layout width="match parent" 
android:layout height="wrap content" 
android:background="@drawable/title bg"> 


<Button 
android:id="@+id/title back" 
android:Layout width="wrap content" 
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android:layout height="wrap content" 
android:layout gravity="center" 
android:Layout margin="5dp" 
android:background="@drawable/back bg" 
android:text="Back" 
android:textColor="#fff" /> 


<TextView 
android:id="@+id/title text" 
android:Layout width="0dp" 
android:layout height="wrap content" 
android:layout gravity="center" 
android:layout weight="1" 
android:gravity="center" 
android:text="Title Text" 
android:textColor="#fff" 
android:textSize="24sp" /> 


<Button 
android:id="@+id/title edit" 
android:layout width="wrap _ content" 
android:layout height="wrap content" 
android:layout gravity="center" 
android:Layout margin="5dp" 
android:background="@drawable/edit bg" 
android:text="Edit" 
android:textColor="#fff" /> 


</LinearLayout> 


可 以 看 到 ， 我 们 在 LinearLayout 中 分 别 加 入 了 两 个 Button 和 一 个 TextView， 左 边 的 Button 
可 用 于 返回 ， 右 边 的 Button 可 用 于 编辑 ， 中 间 的 TextView 则 可 以 显示 一 段 标题 文本 。 上 面 代码 
中 的 大 多 数 属性 都 是 你 已 经 见 过 的 ， 下 面 我 来 说 明 一 下 几 个 之 前 没有 讲 过 的 属性 。android: 


background 用 于 为 布局 或 控件 指定 一 个 背景 ， 可 以 使 用 颜色 或 
title bg.png、back bg.png 和 edit bg.png， 分 别 用 于 作为 标题 栏 、 返 回 按钮 和 
编辑 按钮 的 背景 。 另 外 ， 在 两 个 Button 中 我 们 都 使 用 了 android:tLayout_margin 这 个 属性 ， 它 


备 好 了 3 张 图 片 


图 片 来 进行 填充 ， 这 里 我 提前 准 


可 以 指定 控件 在 上 下 左右 方向 上 偏 移 的 距离 ， 当 然 也 可 以 使 用 android:layout_marginLeft 或 
android:layout _ marginTop 等 属性 来 单独 指定 控件 在 某 个 方向 上 偏 移 的 距离 。 
现在 标题 栏 布局 已 经 编写 完成 了 ， 剩 下 的 就 是 如 何在 程序 中 使 用 这 个 标题 栏 了 ， 修 改 


activity_main.xml 中 的 代码 ， 如 下 所 示 : 


<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 


android:layout width="match parent" 
android:layout height="match parent" > 


<include layout="@layout/title" /> 


</LinearLayout> 


没 错 ! 我 们 只 需要 通过 一 行 incLude 语句 将 标题 栏 布局 引入 进 来 就 可 以 了 。 
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最 后 别 忘 了 在 MainActivity 中 将 系统 自 带 的 标题 栏 隐 藏 掉 ， 代 码 如 下 所 示 : 
public class MainActivity extends AppCompatActivity { 


@Override 
protected void onCreate(Bundle savedInstanceState) { 
super.onCreate(savedInstanceState); 
setContentView(R.layout.activity main); 
ActionBar actionbar = getSupportActionBar(); 
if (actionbar != nuLL) { 
actionbar.hide() ; 


} 


} 


这 里 我 们 调用 了 getSupportActionBar() 方 法 来 获得 ActionBar 的 实例 ， 然 后 再 调用 
ActionBar 的 hide() 方 法 将 标题 栏 隐藏 起 来 。 关 于 ActionBar 的 更 多 用 法 我 们 将 会 在 第 12 章 中 讲 
解 ， 现 在 你 只 需要 知道 可 以 通过 这 种 写法 来 隐藏 标题 栏 就 足够 了 。 现 在 运行 一 下 程序 ,效果 如 图 
3.29 所 示 。 
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图 3.29 引入 标题 栏 布局 的 效果 
使 用 这 种 方式 ， 不管 有 多 少 布局 需要 添加 标题 栏 ， 只 需 一 行 incLude 语句 就 可 以 了 。 


3.4.2 ”创建 自 定义 控件 

引入 布局 的 技巧 确实 解决 了 重复 编写 布局 代码 的 问题 ,但 是 如 果 布 局 中 有 一 些 控 件 要 求 能 够 
响应 事件 , 我 们 还 是 需要 在 每 个 活动 中 为 这 些 控件 单独 编写 一 次 事件 注册 的 代码 。 比 如 说 标题 栏 
中 的 返回 按钮 ， 其 实 不 管 是 在 哪 一 个 活动 中 ,这 个 按钮 的 功能 都 是 相同 的 ， 即 销毁 当前 活动 。 而 
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如 果 在 每 一 个 活动 中 都 需要 重新 注册 一 壳 返 回 按钮 的 点 击 事件 , 无 疑 会 增加 很 多 重复 代码 , 这 种 
情况 最 好 是 使 用 自 定义 控件 的 方式 来 解决 。 
新 建 TitleLayout 继承 自 LinearLayout， 让 它 成 为 我 们 自 定义 的 标题 栏 控 件 ， 代 码 如 下 所 示 : 


public class TitleLayout extends LinearLayout { 


public TitleLayout(Context context, AttributeSet attrs) { 
super(context, attrs); 
LayoutInflater.from(context).inflate(R.layout.title, this); 


} 

首先 我 们 重 写 了 LinearLayout 中 带 有 两 个 参数 的 构造 函数 , 在 布局 中 引入 TitleLayout 控件 就 
会 调用 这 个 构造 函数 。 然 后 在 构造 函数 中 需要 对 标题 栏 布局 进行 动态 加 载 ， 这 就 要 借助 
LayoutInflater 来 实现 了 。 通过 LayoutInflater 的 from( ) 方 法 可 以 构建 出 一 个 LayoutInflater 对 
象 , 然后 调用 inflate() 方 法 就 可 以 动态 加 载 一 个 布局 文件 ，inflate() 方 法 接收 两 个 参数 ,第 

个 参数 是 要 加 载 的 布局 文件 的 id， 这 里 我 们 传人 R.layout.title， 第 二 个 参数 是 给 加 载 好 的 布局 

再 添加 一 个 父 布局 ， 这 里 我 们 想 要 指定 为 TitleLayout， 于 是 直接 传人 this。 

现在 自 定义 控件 已 经 创建 好 了 ， 然 后 我 们 需要 在 布局 文件 中 添加 这 个 自 定义 控件 ， 修 改 
activity_main.xml 中 的 代码 ， 如 下 所 示 : 


<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:layout width="match parent" 
android:layout height="match parent" > 


du 


<com.example.uicustomviews.TitleLayout 
android:layout width="match parent" 
android:layout height="wrap content" /> 


</LinearLayout> 

添加 自 定义 控件 和 添加 普通 控件 的 方式 基本 是 一 样 的 ,只 不 过 在 添加 自 定义 控件 的 时 候 , 我 
们 需要 指明 控件 的 完整 类 名 ， 包 名 在 这 里 是 不 可 以 省 略 的 。 
新 运行 程序 ， 你 会 发 现 此 时 效果 和 使 用 引入 布局 方式 的 效果 是 一 样 的 。 
下 面 我 们 尝试 为 标题 栏 中 的 按钮 注册 点 击 事件 ， 修 改 TitleLayout 中 的 代码 ， 如 下 所 示 : 


public class TitleLayout extends LinearLayout { 


[hdl\ 


public TitleLayout(Context context, AttributeSet attrs) { 
super(context, attrs); 
LayoutInflater.from(context).inflate(R.layout.title, this); 
Button titleBack = (Button) findViewById(R.id.title back); 
Button titLeEdit = (Button) findViewById(R.id.title edit); 
titleBack.setOnClickListener(new OnClickListener() { 
@Override 
public void onClick(View v) { 


3.5 最 常用 和 最 难 用 的 控件 
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((Activity) getContext()).finish(); 
} 
}); 
titleEdit.setOnClickListener(new OnClickListener() { 
@Override 
public void onClick(View v) { 
Toast.makeText (getContext(), "You clicked Edit button", 
Toast .LENGTH_ SHORT) .show() ; 


}); 


首先 还 是 通过 findViewById() 方 法 得 到 按钮 的 实例 ,然后 分 别 调用 setOnClickListener() 
方法 给 两 个 按钮 注册 了 点 击 事件 ， 当 点 击 返 回 按钮 时 销毁 掉 当 前 的 活动 ， 当 点 击 编 辑 按 钮 时 弹出 


一 段 文本 。 重 新 运行 程序 ， 点 击 一 下 编辑 按钮 ， 效 果 如 图 3.30 所 示 。 
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3.30 ”点击 编辑 按钮 的 效果 


这 样 的 话 , 每 当 我 们 在 一 个 布局 中 引入 TitleLayout 时 , 返回 按钮 和 编辑 按钮 的 点 击 事件 就 已 


经 自动 实现 好 了 ， 这 就 省 去 了 很 多 编写 重复 代码 的 工作 。 


3.5 ”最 常用 和 最 难 用 的 控件 一 一 ListView 


ListView 绝对 可 以 称 得 上 是 Android 中 最 常用 的 控件 之 一 ,几乎 所 有 的 应 用 程序 都 会 用 到 它 。 
由 于 手机 屏幕 空间 都 比较 有 限 , 能 够 一 次 性 在 屏幕 上 显示 的 内 容 并 不 多 ， 当 我 们 的 程序 中 有 大 量 
的 数据 需要 展示 的 时 候 , 就 可 以 借助 ListView 来 实现 。ListView 允许 用 户 通 过 手指 上 下 滑动 的 方 


式 将 屏幕 外 的 数据 滚动 到 屏幕 内 , 同时 屏幕 上 原 有 的 数据 则 会 滚动 出 屏幕 。 相 信 你 其 实 每 天 都 在 


使 用 这 个 控件 ， 比 如 查看 QQ 聊天 记录 ， 翻 阅 微 博 最 新 消息 ， 等 等 。 


114 第 3 章 软件 也 要 拼 脸 蛋 一 一 UI 开发 的 点 点 滴 滴 


不 过 比 起 前 面 介绍 的 几 种 控件 ，ListView 的 用 法 也 相对 复杂 了 很 多 ， 因 此 我 们 就 单独 使 用 一 
节 内 容 来 对 ListView 进行 非常 详细 的 讲解 。 


3.5.1 ListView 的 简单 用 法 


首先 新 建 一 个 ListViewTest 项 目 ， 并 让 Android Studio 自动 帮 我 们 创建 好 活动 。 然 后 修改 
activity_main.xml 中 的 代码 ， 如 下 所 示 : 


<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:layout width="match parent" 
android:layout height="match parent"> 


<ListView 
android:id="@+id/list view" 
android:layout width="match parent" 
android:layout height="match parent" /> 


</LinearLayout> 

在 布局 中 加 入 ListView 控件 还 算 非 常 简单 ， 先 为 ListView 指定 一 个 id， 然 后 将 宽度 和 高 度 
都 设置 为 match_parent， 这 样 ListView 也 就 占 满 了 整个 布局 的 空间 。 

接 下 来 修改 MainActivity 中 的 代码 ， 如 下 所 示 : 


public class MainActivity extends AppCompatActivity { 


private String[] data = { "Apple", "Banana", "Orange", "Watermelon", 
"Pear", "Grape", "Pineapple", "Strawberry", "Cherry", "Mango", 
"Apple", "Banana", "Orange", "Watermelon", "Pear", "Grape", 
"Pineapple", "Strawberry", "Cherry", "Mango" }; 


@Override 

protected void onCreate(Bundle savedInstanceState) { 
super.onCreate(savedInstanceState); 
setContentView(R.layout.activity main); 
ArrayAdapter<String> adapter = new ArrayAdapter<String>( 

MainActivity.this, android.R.layout.simple list item 1, data); 

ListView listView = (ListView) findViewById(R.id.list view); 
listView.setAdapter (adapter); 


} 

既然 ListView 是 用 于 展示 大 量 数据 的 , 那 我 们 就 应 该 先 将 数据 提供 好 。 这 些 数据 可 以 是 从 网 
上 下 载 的 , 也 可 以 是 从 数据 库 中 读 取 的 , 应 该 视 具体 的 应 用 程序 场景 而 定 。 这 里 我 们 就 简单 使 用 
了 一 个 data 数组 来 测试 ， 里 面包 含 了 很 多 水 果 的 名 称 。 

不 过 , 数组 中 的 数据 是 无 法 直接 传递 给 ListView 的 , 我 们 还 需要 借助 适配器 来 完成 。Android 
中 提供 了 很 多 适配器 的 实现 类 ， 其 中 我 认为 最 好 用 的 就 是 ArrayAdapter。 它 可 以 通过 谤 型 来 指定 
要 适 配 的 数据 类 型 ， 然 后 在 构造 函数 中 把 要 适 配 的 数据 传人 。ArrayAdapter 有 多 个 构造 函数 的 重 
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载 ， 你 应 该 根据 实际 情况 选择 最 合适 的 一 种 。 这 里 由 于 我 们 提供 的 数据 都 是 字符 串 ， 因 此 将 
ArrayAdapter 的 泛 型 指定 为 String， 然 后 在 ArrayAdapter 的 构造 函数 中 依次 传人 当前 上 下 文 、 
ListView 子 项 布局 的 id， 以 及 要 适 配 的 数据 。 注 意 ， 我 们 使 用 了 android.R.Layout.simpte 
list_item 1 作为 ListView 子 项 布局 的 id， 这 是 一 个 Android 内 置 的 布局 文件 ， 里 面 只 有 一 个 
TextView， 可 用 于 简单 地 显示 一 段 文 本 。 这 样 适 配器 对 象 就 构建 好 了 。 

最 后 ,还 需要 调用 ListView 的 setAdapter() 方 法 , 将 构建 好 的 适配器 对 象 传 递 进去 ， 这样 
ListView 和 数据 之 间 的 关联 就 建立 完成 了 。 


现在 运行 一 下 程序 ， 效 果 如 图 3.31 所 示 。 可 以 通过 滚动 的 方式 来 查看 屏幕 外 的 数据 。 
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图 3.31 ListView 运行 效果 


3.5.2 ”定制 ListView 的 界面 

只 能 显示 一 段 文本 的 ListView 实在 是 太 单调 了 ,我 们 现在 就 来 对 ListView 的 界面 进行 定制 ， 
让 它 可 以 显示 更 加 丰富 的 内 容 。 

首先 需要 准备 好 一 组 图 片 , 分 别 对 应 上 面 提供 的 每 一 种 水 果 ， 待 会 我 们 要 让 这 些 水 果 名 称 的 
旁边 都 有 一 个 图 样 。 

接着 定义 一 个 实体 类 ， 作 为 ListView 适配器 的 适 配 类 型 。 新 建 类 Fruit， 代 码 如 下 所 示 : 


public class Fruit { 


private String name; 


private int imageld; 


116 第 3 章 ”软件 也 要 拼 脸蛋 一 一 UI 开发 的 点 点 滴 滴 


public Fruit(String name, int imageId) { 
this.name = name; 
this.imageld = imageld; 

} 


public String getName() { 
return name; 


} 


public int getImageId() { 
return imageld; 


} 
} 
Fruit 类 中 只 有 两 个 字段 ，name 表示 水 果 的 名 字 ，imageId 表示 水 果 对 应 图 片 的 资源 id。 
然后 需要 为 ListView 的 子 项 指定 一 个 我 们 自 定义 的 布局 ,在 layout 目录 下 新 建 fuit_item.xml， 
代码 如 下 所 示 : 
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 


android:layout width="match parent" 
android:layout height="wrap content"> 


<ImageView 
android:id="@+id/fruit image" 
android:layout width="wrap content" 
android:layout height="wrap content" /> 


<TextView 
android:id="@+id/fruit name" 
android:layout width="wrap content" 
android:layout height="wrap content" 
android:layout gravity="center vertical" 
android:Layout marginLeft="1l0dp" /> 


</LinearLayout> 


在 这 个 布局 中 ， 我们 定义 了 一 个 ImageView 用 于 显示 水 果 的 图 片 ， 又 定义 了 一 个 TextView 
用 于 显示 水 果 的 名 称 ， 并 让 TextView 在 垂直 方向 上 居中 显示 。 


接 下 来 需要 创建 一 个 自 定义 的 适配器 ， 这 个 适配器 继承 自 ArrayAdapter， 并 将 泛 型 指定 为 
Fruit 类 。 新 建 类 FruitAdapter， 代 码 如 下 所 示 : 


public class FruitAdapter extends ArrayAdapter<Fruit> { 


private int resourceId ; 


public FruitAdapter(Context context, int textViewResourceld, 
List<Fruit> objects) { 
super(context, textViewResourceld, objects); 
resourceld = textViewResourceld; 
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@Override 

public View getView(int position, View convertView, ViewGroup pa 
Fruit fruit = getItem(position); // 获取 当前 项 的 Fruit 实例 
View view = LayoutInflater.from(getContext()).inflate(resour 

false); 

ImageView fruitImage = (ImageView) view.findViewById(R.id.fr 
TextView fruitName = (TextView) view.findViewById(R.id.fruit 
fruitImage.SsetImageResource(fruit.getImageId() ) ; 
fruitName.setText(fruit.getName()); 
return view; 


} 


rent) { 
celd, parent, 


uit image); 
_name ) ; 


FruitAdapter 重 写 了 父 类 的 一 组 构造 函数 ， 用 于 将 上 下 文 、ListView 子 项 布局 的 id 和 数据 
都 传递 进来 。 另外 又 重 写 了 getView() 方 法 , 这 个 方法 在 每 个 子 项 被 滚动 到 屏幕 内 的 时 候 会 被 调 


用 。 在 getView() 方 法 中 ， 首 先 通过 getItem() 方 法 得 到 当前 项 的 Fruit 实例 ， 然 后 使 用 


LayoutInflater 来 为 这 个 子 项 加 载 我 们 传人 的 布局 。 


这 里 LayoutInflater 的 inflate() 方 法 接收 3 个 参数 ， 前 两 个 参数 我 们 已 经 知道 是 什么 


意思 了 ， 第 三 个 参数 指定 成 fatse， 表 示 只 让 我 们 在 父 布局 中 声明 的 Layout 属 ' 


性 生效 ,但 不 会 


为 这 个 View 添加 父 布局 ， 因 为 一 旦 View 有 了 父 布局 之 后 ， 它 就 不 能 再 添加 到 ListView 中 了 。 
如 果 你 现在 还 不 能 理解 这 段 话 的 含义 也 没关系 ， 只 需要 知道 这 是 ListView 中 的 标准 写法 就 可 以 


了 ， 当 你 以 后 对 View 理解 得 更 加 深刻 的 时 候 ， 再 来 读 这 段 话 就 没有 问题 了 。 


我 们 继续 往 下 看 ， 接 下 来 调用 View 的 findViewById() 方 法 分 别 获取 到 ImageView 和 
TextView 的 实例 ， 并 分 别 调用 它们 的 setImageResource() 和 setText () 方 法 来 设置 显示 的 图 


片 和 文字 ， 最 后 将 布局 返回 ， 这 样 我 们 自 定 义 的 适配器 就 完成 了 。 
下 面 修改 MainActivity 中 的 代码 ， 如 下 所 示 : 


public class MainActivity extends AppCompatActivity { 


private List<Fruit> fruitList = new ArrayList<>(); 


@Override 

protected void onCreate(Bundle savedInstanceState) { 
super.onCreate(savedInstanceState); 
setContentView(R.layout.activity main); 
initFruits(); // 初始 化 水 果 数 据 
FruitAdapter adapter = new FruitAdapter (MainActivity.this, 

R.layout.fruit item, fruitList); 

ListView listView = (ListView) findViewById(R.id,List view); 
listView.setAdapter(adapter); 

} 


private void initFruits() { 
for (int i = 0; i < 2; i++) { 
Fruit apple = new Fruit("Apple", R.drawable.apple pic); 
fruitList.add(apple); 
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Fruit banana = new Fruit("Banana", R.drawable.banana pic); 


fruitList.add(banana); 


Fruit orange = new Fruit("Orange", R.drawable.orange pic); 


fruitList.add(orange); 


Fruit watermelon = new Fruit("Watermelon", R.drawable.watermelon pic); 


fruitList.add(watermelon); 

Fruit pear = new Fruit("Pear", R.drawable.pear pic); 
fruitList.add(pear); 

Fruit grape = new Fruit("Grape", R.drawable.grape pic); 
fruitList.add(grape); 


Fruit pineapple = new Fruit("Pineapple", R.drawable.pineapple pic); 


fruitList.add(pineapple); 


Fruit strawberry = new Fruit("Strawberry", R.drawable.strawberry pic); 


fruitList.add(strawberry); 


Fruit cherry = new Fruit("Cherry", R.drawable.cherry pic); 


fruitList.add(cherry); 
Fruit mango = new Fruit("Mango", R.drawable.mango pic); 
fruitList.add(mango); 


} 


可 以 看 到 ,这 里 添加 了 一 个 initFruits() 方 法 , 用 于 初始 化 所 有 的 水 果 数据 。 在 Fruit 类 


的 构造 函数 中 将 水 果 的 名 字 和 对 应 的 图 片 id 传 入 ， 然 后 把 创建 好 的 对 象 添加 到 水 


果 列 表 中 。 田 


外 我 们 使 用 了 一 个 for 循环 将 所 有 的 水 果 数 据 添 加 了 两 遍 , 这 是 因为 如 果 只 添加 一 遍 的 话 , 数据 
量 还 不 足以 充满 整个 屏幕 。 接 着 在 onCreate ( ) 方 法 中 创建 了 FruitAdapter 对 象 , 并 将 Fruit- 


Adapter 作为 适配器 传递 给 ListView， 这 样 定制 ListView 界面 的 任务 就 完成 了 。 
现在 重新 运行 程序 ， 效 果 如 图 3.32 所 示 。 
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图 3.32 定制 界面 的 ListView 运行 效果 
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虽然 目前 我 们 定制 的 界面 还 很 简单 ， 但 是 相信 聪明 的 你 已 经 领悟 到 了 诀 穿 ， 只 要 修改 


fruit_item.xml 中 的 内 容 ， 就 可 以 定制 出 各 种 复杂 的 界面 了 。 


3.5.3 ”提升 ListView 的 运行 效率 


之 所 以 说 ListView 这 个 控件 很 难 用 , 就 是 因为 它 有 很 多 细节 可 以 优化 , 其 中 运行 效率 就 是 很 
重要 的 一 点 。 目 前 我 们 ListView 的 运行 效率 是 很 低 的 ， 因 为 在 FruitAdapter 的 getView() 方 
法 中 ， 每 次 都 将 布局 重新 加 载 了 一 遍 ， 当 ListView 快速 滚动 的 时 候 ， 这 就 会 成 为 性 能 的 瓶颈 。 

仔细 观察 会 发 现 ，getView( ) 方 法 中 还 有 一 个 convertView 参数 ， 这 个 参数 用 于 将 之 前 加 
载 好 的 布局 进行 缓存 ， 以 便 之 后 可 以 进行 重用 。 修 改 FruitAdapter 中 的 代码 ， 如 下 所 示 : 


public class FruitAdapter extends ArrayAdapter<Fruit> { 


GOverride 


public View getView(int position, View convertView, ViewGroup parent) { 


Fruit fruit = getItem(position); 
View view; 
if (convertView == nuLL) { 


view = LayoutInflater.from(getContext()).inflate(resourceId, parent, 


false); 
} else{ 
view = convertView; 


} 


ImageView fruitImage = (ImageView) view.findViewById(R.id.fruit image); 
TextView fruitName = (TextView) view.findViewById(R.id.fruit name); 


fruitImage.setImageResource(fruit.getImageId() ) ; 
fruitName.setText(fruit.getName()); 
return view; 


J 


可 以 看 到 , 现在 我 们 在 getView( ) 方 法 中 进行 了 判断 ， 如 果 convertView 为 nutl, 则 使 用 
LayoutInflater 去 加 载 布局 , 如 果 不 为 nuLtL 则 直接 对 convertVview 进行 重用 。 这 样 就 大 大 提 


高 了 ListView 的 运行 效率 ， 在 快速 滚动 的 时 候 也 可 以 表现 出 更 好 的 性 能 。 


不 过 , 目前 我 们 的 这 份 代 码 还 是 可 以 继续 优化 的 , 虽然 现在 已 经 不 会 


再 重复 去 加 载 布局 , 但 


是 每 次 在 getView() 方 法 中 还 是 会 调用 View 的 findViewById() 方 法 来 获取 一 次 控件 的 实例 。 
我 们 可 以 借助 一 个 ViewHolder 来 对 这 部 分 性 能 进行 优化 , 修改 FruitAdapter 中 的 代码 ， 如 下 


所 示 : 


public class FruitAdapter extends ArrayAdapter<Fruit> { 


GOverride 
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public View getView(int position, View convertView, ViewGroup parent) { 
Fruit fruit = getItem(position); 
View view; 
ViewHolder viewHolder; 
if (convertView == null) { 
view = LayoutInflater.from(getContext()).inflate(resourceId, parent, 
false); 
viewHolder = new ViewHolder(); 
viewHolder.fruitImage = (ImageView) view.findViewById 
(R.id.fruit image); 
viewHolder.fruitName = (TextView) view.findViewById (R.id.fruit name); 
view.setTag(viewHolder); // 将 ViewHolder 存储 在 View 中 
} else { 
View = convertView; 
viewHolder = (ViewHolder) view.getTag(); // 重新 获取 ViewHolder 
viewHoLder.fruitImage.setImageResource(fruit.getImageId() ) ; 
ViewHoLder .fruitName.setText(fruit.getName() ) ; 
return view; 
} 
class ViewHolder { 
ImageView fruitImage; 
TextView fruitName; 
} 
} 


我 们 新 增 了 一 个 内 部 类 ViewHotlder, 用 于 对 控件 的 实例 进行 缓存 。 当 convertView 为 null 
的 时 候 , 创建 一 个 ViewHolder 对 象 , 并 将 控件 的 实例 都 存放 在 ViewHolder 里 , 然后 调用 View 
的 setTag() 方 法 ,将 ViewHolder 对 象 存储 在 View 中 。 当 convertView 不 为 null 的 时 候 ， 
则 调用 View 的 getTag() 方 法 , 把 ViewHolder 重新 取出 。 这 样 所 有 控件 的 实例 都 缓存 在 了 
ViewHolder 里 ， 就 没有 必要 每 次 都 通过 findViewById() 方 法 来 获取 控件 实例 了 。 


通过 这 两 步 优化 之 后 ， 我 们 ListView 的 运行 效率 就 已 经 非常 不 错 了 。 


3.5.4 ”ListView 的 点 击 事件 


话说 回来 ,ListView 的 滚动 毕竟 只 是 满足 了 我 们 视觉 上 的 效果 , 可 是 如 果 ListView 中 的 子 项 
不 能 点 击 的 话 , 这 个 控件 就 没有 什么 实际 的 用 途 了 。 因 此 , 本 小 节 我 们 就 来 学 习 一 下 ListView 如 


何 才 能 响应 用 户 的 点 击 事件 。 


修改 MainActivity 中 的 代码 ， 如 下 所 示 : 


public class MainActivity extends AppCompatActivity { 


private List<Fruit> fruitList = new ArrayList<>(); 
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@Override 
protected void onCreate(Bundle savedInstanceState) { 
super.onCreate(savedInstanceState); 
setContentView(R.layout.activity main); 
initFruits(); 
FruitAdapter adapter = new FruitAdapter(MainActivity,this，R.Layout ， 
fruit item, fruitList); 
ListView listView = (ListView) findViewById(R.id.list view); 
listView.setAdapter(adapter); 
listView.setOnItemClickListener(new AdapterView.OnItemClickListener() { 
@Override 
public void onItemCLick(AdapterView<?> parent, View view, 
int position, long id) { 
Fruit fruit = fruitList.get(position); 
Toast.makeText (MainActivity.this, fruit.getName(), 
Toast.LENGTH_ SHORT) .show() ; 


}); 


} 


可 以 看 到 ， 我 们 使 用 set0nItemCLickListener() 方 法 为 ListView 注册 了 一 个 监听 器 ， 当 
用 户 点 击 了 ListView 中 的 任何 一 个 子 项 时 ， 就 会 回调 onItemClick() 方 法 。 在 这 个 方法 中 可 以 
通过 position 参数 判断 出 用 户 点 击 的 是 哪 一 个 子 项 ， 然 后 获取 到 相应 的 水 果 ， 并 通过 Toast 将 
水 果 的 名 字 显 示 出 来 。 


重新 运行 程序 ， 并 点 击 一 下 橘子 ， 效 果 如 图 3.33 所 示 。 
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图 3.33 点击 ListView 的 效 呈 
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3.6 更 强大 的 滚动 控件 一 一 RecyclerView 


ListView 由 于 其 强大 的 功能 ， 在 过 去 的 Android 开发 当中 可 以 说 是 贡献 卓越 ， 直 到 今天 仍然 
还 有 不 计 其 数 的 程序 在 继续 使 用 着 ListView。 不 过 ListView 并 不 是 完全 没有 缺点 的 ， 比 如 说 如 果 
我 们 不 使 用 一 些 技巧 来 提升 它 的 运行 效率 , 那么 ListView 的 性 能 就 会 非常 差 。 还 有 ，ListView 的 
扩展 性 也 不 够 好 ， 它 只 能 实现 数据 纵向 滚动 的 效果 ， 如 果 我 们 想 实现 横向 滚动 的 话 ，ListView 是 
做 不 到 的 。 

为 此 ，Android 提供 了 一 个 更 强大 的 滚动 控件 RecyclerView。 它 可 以 说 是 一 个 增强 版 的 
ListView , 不 仅 可 以 轻松 实现 和 ListView 同样 的 效果 , 还 优化 了 ListView 中 存在 的 各 种 不 足 之 处 。 
目前 Android 官方 更 加 推荐 使 用 RecyclerView ， 未 来 也 会 有 更 多 的 程序 逐渐 从 ListView 转向 
RecyclerView， 那 么 本 节 我 们 就 来 详细 讲解 一 下 RecyclerView 的 用 法 。 

首先 新 建 一 个 RecyclerViewTest 项目， 并 让 Android Studio 自动 帮 有 我们 创建 好 活动 。 


3.6.1 RecyclerView 的 基本 用 法 


和 百分比 布局 类 似 ，RecyclerView 也 属于 新 增 的 控件 ， 为 了 让 RecyclerView 在 所 有 Android 
版 本 上 都 能 使 用 ,Android 团队 采取 了 同样 的 方式 , 将 RecyclerView 定义 在 了 support 库 当 中 。 
此 ， 想 要 使 用 RecyclerView 这 个 控件 ， 首 先 需 要 在 项 目的 build.gradle 中 添加 相应 的 依赖 库 才 行 。 


打开 app/build.gradle 文件 ， 在 dependencies 闭 包 中 添加 如 下 内 容 : 


dependencies { 
compile fileTree(dir: 'libs', include: ['*.jar']) 
compile 'com.android,.support:appcompat-v7:24.2.1" 
compile 'com.android.support:recyclerview-v7:24.2.1' 
testCompile 'junit:junit:4.12， 


} 
添加 完 之 后 记得 要 点 击 一 下 Sync Now 来 进行 同步 。 然 后 修改 activity_main.xml 中 的 代码 ， 
如 下 所 示 : 


<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:layout width="match parent" 
android:layout height="match parent"> 


<android,.support.v7.widget.RecyclerView 
android:id="@+id/recycler view" 
android:layout width="match parent" 
android:layout height="match parent" /> 


</LinearLayout> 

在 布局 中 加 入 RecyclerView 控件 也 是 非常 简单 的 ， 先 为 RecyclerView 指定 一 个 id， 然 后 将 
宽度 和 高 度 都 设置 为 match_parent， 这 样 RecyclerView 也 就 占 满 了 整个 布局 的 空间 。 需 要 注意 
的 是 ， 由 于 RecyclerView 并 不 是 内 置 在 系统 SDK 当中 的 ， 所 以 需要 把 完整 的 包 路 径 写 出 来 。 


3.6 更 强大 的 滚动 控件 


RecyclerView 123 


这 里 我 们 想 要 使 用 RecyclerView 来 实现 和 ListView 相同 的 效果 ， 因 此 裔 
的 水 果 图 片 。 简 单 起 见 ， 我 们 就 直接 从 ListViewTest 项目 中 把 图 片 复制 过 来 高 


将 Fruit 类 和 fruit item.xml 也 复制 过 来 ， 省 得 将 同样 的 代码 再 写 一 


需要 准备 一 份 同样 


一 遍 。 


i 可 以 了 ， 男 外 顺便 


接 下 来 需要 为 RecyclerView 准备 一 个 适配器 , 新建 FruitAdapter 类 , 让 这 个 适配器 继承 自 


RecyclerView.Adapter， 并 将 泛 型 指定 为 FruitAdapter.ViewHolder。 其 


是 我 们 在 FruitAdapter 中 定义 的 一 个 内 部 类 ， 代 码 如 下 所 示 : 


其 中 ,ViewHolder 


public class FruitAdapter extends RecyclerView.Adapter<FruitAdapter.ViewHolder> { 


private List<Fruit> mFruitList; 


static class ViewHolder extends RecyclerView.ViewHolder { 


ImageView fruitImage; 
TextView fruitName; 


public ViewHolder(View view) { 
super (view); 


fruitImage = (ImageView) view.findViewById(R.id.fruit image); 
fruitName = (TextView) view.findViewById(R.id.fruit name); 


} 


public FruitAdapter(List<Fruit> fruitList) { 
mFruitList = fruitList; 
} 


GOverride 


public ViewHolder onCreateViewHolder(ViewGroup parent, 


View view = LayoutInflater.from(parent.getContext()) 
.inflate(R.layout.fruit item, parent, false); 


ViewHolder holder = new ViewHolder(view); 
return holder; 
} 


GOverride 


int viewType) { 


public void onBindViewHolder(ViewHolder holder, int position) { 


Fruit fruit = mFruitList.get(position); 


holder.fruitImage.setImageResource(fruit.getImagelId()); 


holder.fruitName.setText(fruit.getName()); 
} 


GOverride 
public int getItemCount() { 
return mFruitList.size(); 


} 
} 


虽然 这 段 代 码 看 上 去 好 像 有 点 长 , 但 其 实 它 比 ListView 的 适 配 


ViewHolder 的 构造 函数 中 要 传人 一 个 View 参数 ， 这 个 参数 通 


器 要 更 容易 理解 。 这 里 我 们 首 
先 定义 了 一 个 内 部 类 ViewHoLder，ViewHotder 有 RecyclerView.ViewHolder。 然 后 
常 就 是 RecyclerView 子 项 的 最 外 
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层 布 局 ， 那 么 我 们 就 可 以 通过 findViewById() 方 法 来 获取 到 布局 中 的 ImageView 和 TextView 
的 实例 了 。 

接着 往 下 看 , FruitAdapter 中 也 有 一 个 构造 函数 , 这 个 方法 用 于 把 要 展示 的 数据 源 传 进来 ， 
并 赋值 给 一 个 全 局 变量 mFruitList， 我们 后 续 的 操作 都 将 在 这 个 数据 源 的 基础 上 进行 。 

继续 往 下 看 ， 由 于 FruitAdapter 是 继承 自 RecyclerView.Adapter 的 ， 那么 就 必须 重 写 
onCreateViewHolder()、onBindViewHolder() 和 getItemCount() 这 3 个 方法 。onCreate- 
ViewHolder() 方 法 是 用 于 创建 ViewHolder 实例 的 , 我 们 在 这 个 方法 中 将 fruit_item 布局 加 载 
进来 ， 然 后 创建 一 个 ViewHolder 实例 ， 并 把 加 载 出 来 的 布局 传人 到 构造 函数 当中 ， 最 后 将 
ViewHolder 的 实例 返回 。 onBindViewHolder() 方 法 是 用 于 对 RecyclerView 子 项 的 数据 进行 赋值 
的 , 会 在 每 个 子 项 被 滚动 到 屏幕 内 的 时 候 执行 , 这 里 我 们 通过 position 参数 得 到 当前 项 的 Fruit 
实例 ， 然 后 再 将 数据 设置 到 ViewHolder 的 ImageView 和 TextView 当中 即 可 。getItemCount() 
方法 就 非常 简单 了 , 它 用 于 告诉 RecyclerView 一 共有 多 少子 项 , 直接 返回 数据 源 的 长 度 就 可 以 了 。 

适配器 准备 好 了 之 后 ， 我 们 就 可 以 开始 使 用 RecyclerView 了， 修改 MainActivity 中 的 代码 ， 
如 下 所 示 : 


public class MainActivity extends AppCompatActivity { 


Im 


private List<Fruit> fruitList = new ArrayList<>(); 


@Override 

protected void onCreate(Bundle savedInstanceState) { 
super.onCreate(savedInstanceState); 
setContentView(R.layout.activity main); 
initFruits(); // 初始 化 水 果 数 据 
RecyclerView recyclerView = (RecyclerView) findViewById(R.id.recycler view); 
LinearLayoutManager LayoutManager = new LinearLayoutManager(this); 
recyclerView.setLayoutManager (layoutManager); 
FruitAdapter adapter = new FruitAdapter(fruitList); 
recyclerView. setAdapter(adapter); 

} 


private void initFruits() { 

for (int i = 0; i < 2; i++) { 
Fruit apple = new Fruit("Apple", R.drawable.apple pic); 
fruitList.add(apple); 
Fruit banana = new Fruit("Banana", R.drawable.banana pic); 
fruitList.add(banana); 
Fruit orange = new Fruit("Orange", R.drawable.orange pic); 
fruitList.add(orange); 
Fruit watermelon = new Fruit("Watermelon", R.drawable.watermelon pic); 
fruitList.add(watermelon); 
Fruit pear = new Fruit("Pear", R.drawable.pear pic); 
fruitList.add(pear); 
Fruit grape = new Fruit("Grape", R.drawable.grape pic); 
fruitList.add(grape); 
Fruit pineapple = new Fruit("Pineapple", R.drawable.pineapple pic); 
fruitList.add(pineapple); 
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Fruit strawberry = new Fruit("Strawberry", R.drawable.strawberry pic); 
fruitList.add(strawberry); 

Fruit cherry = new Fruit("Cherry", R.drawable.cherry pic); 
fruitList.add(cherry); 

Fruit mango = new Fruit("Mango", R.drawable.mango pic); 
fruitList.add(mango); 


} 

可 以 看 到 ， 这 里 使 用 了 一 个 同样 的 initFruits() 方 法 ， 用 于 初始 化 所 有 的 水 果 数 据 。 接 着 
在 onCreate() 方 法 中 我 们 先 获取 到 RecyclerView 的 实例 ， 然 后 创建 了 一 个 LinearLayout- 
Manager 对 象 ， 并 将 它 设置 到 RecyclerView 当中 。LayoutManager 用 于 指定 RecyclerView 的 布局 
方式 ， 这 里 使 用 的 LinearLayoutManager 是 线性 布局 的 意思 ， 可 以 实现 和 ListView 类 似 的 效果 。 
接 下 来 我 们 创建 了 FruitAdapter 的 实例 ， 并 将 水 果 数 据 传 人 到 FruitAdapter 的 构造 函数 中 ， 
最 后 调用 RecyclerView 的 setAdapter() 方 法 来 完成 适 配 硕 设置 , 这 样 RecyclerView 和 数据 之 间 
的 关联 就 建立 完成 了 。 

现在 可 以 运行 一 下 程序 了 ， 效 果 如 图 3.34 所 示 。 


WB 11:49 
RecyclerViewTest 


pr 
人 


| 和 


图 3.34 RecyclerView 运行 效果 

可 以 看 到 ， 我 们 使 用 RecyclerView 实现 了 和 ListView 几乎 一 模 一 样 的 效果 ， 虽 说 在 代码 量 

方面 并 没有 明显 地 减少 ， 但 是 逻辑 变 得 更 加 清晰 了 。 当 然 这 只 是 RecyclerView 的 基本 用 法 而 已 ， 
接 下 来 我 们 就 看 一 看 RecyclerView 还 能 实现 哪些 ListView 实现 不 了 的 效果 。 


3.6.2 ”实现 横向 滚动 和 瀑布 流 布局 
我 们 已 经 知道 ，ListView 的 扩展 性 并 不 好 ， 它 只 能 实现 纵向 滚动 的 效果 ， 如 果 想 进行 横向 深 
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动 的 话 ，ListView 就 做 不 到 了 。 那 么 RecyclerView 就 能 做 得 到 吗 ? 当然 可 以 ,不 仅 能 做 得 到 ， 还 
非常 简单 ， 那 么 接 下 来 我 们 就 尝试 实现 一 下 横向 滚动 的 效果 。 

首先 要 对 fruit_itenm 布局 进行 修改 ,因为 目前 这 个 布局 里 面 的 元 素 是 水 平 排列 的 , 适用 于 
纵向 滚动 的 场景 ， 而 如 果 我 们 要 实现 横向 滚动 的 话 , 应 该 把 fruit_item 里 的 元 素 改 成 垂直 排列 
才 比 较 合 理 。 修 改 fuit item.xml 中 的 代码 ， 如 下 所 示 : 


<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:orientation="vertical" 
android:1layout width="100dp" 
android:layout height="wrap content" > 


<ImageView 
android:id="@+id/fruit image" 
android:layout width="wrap content" 
android:layout height="wrap content" 
android:1layout gravity="center horizontal" /> 


<TextView 
android:id="@+id/fruit name" 
android:layout width="wrap content" 
android:layout height="wrap_ content" 
android:layout gravity="center horizontal" 
android:layout marginTop="10dp" /> 


</LinearLayout> 

可 以 看 到 ， 我 们 将 LinearLayout 改 成 垂直 方向 排列 ， 并 把 宽度 设 为 100dp。 这 里 将 宽度 指定 
为 固定 值 是 因为 每 种 水 果 的 文字 长 度 不 一 致 ， 如 果 用 wrap_content 的 话 ，RecyclerView 的 子 项 
就 会 有 长 有 短 ,， 非 常 不 美观 ; 而 如 果 用 match_parent 的 话 ， 就 会 导致 宽度 过 长 ， 一 个 子 项 占 满 
整个 屏幕 。 

然后 我 们 将 ImageView 和 TextView 都 设置 成 了 在 布局 中 水 平 居 中 ， 并 且 使 用 Layout _ 
marginTop 属性 让 文字 和 图 片 之 间 保 持 一 些 距离 。 

接 下 来 修改 MainActivity 中 的 代码 ， 如 下 所 示 : 


public class MainActivity extends AppCompatActivity { 


private List<Fruit> fruitList = new ArrayList<>(); 


@Override 

protected void onCreate(Bundle savedInstanceState) { 
super.onCreate(savedInstanceState);, 
setContentView(R.layout.activity main); 
initFruits(); 
RecyclerView recyclerView= (RecyclerView) findViewById(R.id,.recycler view); 
LinearLayoutManager LayoutManager = new LinearLayoutManager (this); 
layoutManager .setOrientation(LinearLayoutManager .HORIZONTAL); 
recyclerView.setLayoutManager (layoutManager); 
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FruitAdapter adapter = new FruitAdapter(fruitList) ; 
recyclerView.setAdapter(adapter); 
} 


MainActivity 中 只 加 入 了 一 行 代码 , 调用 LinearLayoutManager 的 set0rientation() 方 法 来 
设置 布局 的 排列 方向 ， 默认 是 纵向 排列 的 ， 我们 传 入 LinearLayoutManager .HORIZONTAL 表示 
让 布局 横行 排列 ， 这 样 RecyclerView 就 可 以 横向 滚动 了 。 


重新 运行 一 下 程序 ， 效 果 如 图 3.35 所 示 。 


RecyclerViewTest 


本 0 口 


图 3.35 ”横向 RecyclerView 效果 


你 可 以 用 手指 在 水 平方 向 上 滑动 来 查看 屏幕 外 的 数据 。 

为 什么 ListView 很 难 或 者 根本 无 法 实现 的 效果 在 RecyclerView 上 这 么 轻松 就 能 实现 了 呢 ? 
这 主要 得 益 于 RecyclerView 出 色 的 设计 ,ListView 的 布局 排列 是 由 自身 去 管理 的 ,而 RecyclerView 
则 将 这 个 工作 交 给 了 LayoutManager，LayoutManager 中 制定 了 一 套 可 扩展 的 布局 排列 接口 ， 子 类 
只 要 按照 接口 的 规范 来 实现 ， 就 能 定制 出 各 种 不 同 排列 方式 的 布局 了 。 

除了 LinearLayoutManager 之 外 ，RecyclerView 还 给 我 们 提供 了 GridLayoutManager 和 
StaggeredGridLayoutManager 这 两 种 内 置 的 布局 排列 方式 。GridLayoutManager 可 以 用 于 实现 网 格 
布局 ，StaggeredGridLayoutManager 可 以 用 于 实现 瀑布 流 布局 。 这 里 我 们 来 实现 一 下 效果 更 加 炫 
酷 的 瀑布 流 布 局 ， 网 格 布 局 就 作为 课 后 习题 ， 交 给 你 自己 来 研究 了 。 

首先 还 是 来 修改 一 下 fruit_item.xml 中 的 代码 ， 如 下 所 示 : 

<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 


android:orientation="vertical" 
android:Tlayout width="match_parent" 


128 第 3 章 ”软件 也 要 拼 脸蛋 一 一 UI 开发 的 点 点 滴 滴 


android:layout height=" wrap content" 
android:layout margin="5dp" > 


<ImageView 


android: 
android: 
android: 


android 


<TextView 


android: 
android: 
android: 
android: 
android: 


</LinearLayout> 


这 里 做 了 几 处 小 的 调整 ， 首 先 将 LinearLayout 的 宽度 


id="@+id/fruit image" 
layout width="wrap content" 
layout height="wrap_ content" 


:layout gravity="center horizontal" /> 


id="@+id/fruit name" 

layout width="wrap content" 
layout height="wrap content" 
layout gravity="left" 

layout marginTop="1l0dp" /> 


瀑布 流 布 局 的 宽度 应 该 是 根据 布局 的 列 数 来 自动 适 配 的 ， 而 不 是 一 个 


Layout_margin 属性 来 让 子 项 之 间 互 留 一 点 间距 ， 这 样 就 


就 是 将 TextView 的 对 齐 


100dp 改 成 了 match_parent， 因 为 


固定 值 。 另 外 我 们 使 用 了 


i 不 至 于 所 有 子 项 都 紧 贴 在 一 些 。 还 有 


中 显示 就 会 感觉 怪 怪 的 。 
接着 修改 MainActivity 中 的 代码 ， 如 下 所 示 : 


public class MainActivity extends AppCompatActivity { 


private List<Fruit> fruitList = new ArrayList<>(); 


@Override 


protected void onCreate(Bundle savedInstanceState) { 
super.onCreate(savedInstanceState), 
setContentView(R.layout.activity main); 
initFruits(); 
RecyclerView recyclerView = (RecyclerView) findViewById(R.id,.recycler view); 
StaggeredGridLayoutManager layoutManager = new 
StaggeredGridLayoutManager(3, StaggeredGridLayoutManager .VERTICAL); 
recyclerView.setLayoutManager (layoutManager); 
FruitAdapter adapter = new FruitAdapter(fruitList); 
recyclerView.setAdapter(adapter); 


} 


private void initFruits() { 

for (int i = 0; i < 2; i++) { 

Fruit apple = new Fruit( 

getRandomLengthName ("Apple"), R.drawable.apple pic); 
fruitList.add(apple); 
Fruit banana = new Fruit( 
getRandomLengthName ("Banana"), R.drawable.banana pic); 
fruitList.add(banana); 
Fruit orange = new Fruit( 


属性 改 成 了 居 左 对 齐 ， 因 为 待 会 我 们 会 将 文字 的 长 度 变 长 ， 如 果 还 是 居 
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getRandomLengthName("0range")，R.drawabtLe.orange_pic) ; 
fruitList.add(orange); 
Fruit watermelon = new Fruit( 

getRandomLengthName ("Watermelon"), R.drawable.watermelon pic); 
fruitList.add(watermelon); 
Fruit pear = new Fruit( 

getRandomLengthName ("Pear"), R.drawable.pear pic); 
fruitList.add(pear); 
Fruit grape = new Fruit( 

getRandomLengthName ("Grape"), R.drawable.grape pic); 
fruitList.add(grape); 
Fruit pineapple = new Fruit( 

getRandomLengthName ("Pineapple"), R.drawable.pineapple pic); 
fruitList.add(pineapple); 
Fruit strawberry = new Fruit( 

getRandomLengthName ("Strawberry"), R.drawable.strawberry pic); 
fruitList.add(strawberry); 
Fruit cherry = new Fruit( 

getRandomLengthName ("Cherry"), R.drawable.cherry pic); 
fruitList.add(cherry); 
Fruit mango = new Fruit( 

getRandomLengthName ("Mango"), R.drawable.mango pic); 
fruitList.add(mango); 


String getRandomLengthName(String name) { 


Random random = new Random(); 


length = random.nextInt(20) + 1; 


StringBuilder builder = new StringBuilder(); 


(int i = 0; i < length; i++) { 
builder.append (name); 


return builder.toString(); 


} 
} 
private 
int 
for 
} 
} 
} 
首先 ,在 on 
StaggeredGridL 


Create() 方 法 中 ， 我 们 创建 了 一 个 StaggeredGridLayoutManager 的 实例 。 
ayoutManager 的 构造 函数 接收 两 个 参数 ， 第 一 个 参数 用 于 指定 布局 的 列 数 ， 


传人 3 表示 会 把 布局 分 为 3 列 ; 第 二 个 参数 用 于 指定 布局 的 排列 方向 , 传人 StaggeredGrid- 


LayoutManager. 


VERTICAL 表示 会 让 布局 纵向 排列 ,最 后 再 把 创建 好 的 实例 设置 到 RecyclerView 


当中 就 可 以 了 ， 就 是 这 么 简单 ! 
没 错 , 仅仅 修改 了 一 行 代码 ,我们 就 已 经 成 功 实现 瀑布 流 布局 的 效果 了 。 不 过 由 于 瀑布 流 布 


局 需要 各 个 子 项 的 高 度 不 一 致 才能 看 出 明显 的 效果 , 为 此 我 又 使 用 了 一 个 小 技巧 。 这 里 我 们 把 眼 


光 聚 焦 在 getRan 
20 之 间 的 随机 数 ， 
的 名 字 都 改 成 调 月 


domLengthName () 这 个 方法 上 ， 这 个 方法 使 用 了 Random 对 象 来 创造 一 个 1 到 
然后 将 参数 中 传人 的 字符 串 随机 重复 几 遍 。 在 initFruits () 方 法 中 , 每 个 水 果 


日 getRandomLengthName( ) 这 个 方法 来 生成 ， 这 样 就 能 保证 各 水 果 名 字 的 长 短 


et 
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差距 都 比较 大 ， 子 项 的 高 度 也 就 各 不 相同 了 。 
现在 重新 运行 一 下 程序 ， 效 果 如 图 3.36 所 示 。 


RecyclerViewTest 


@ tb ©@® 


et 
图 3.36 瀑布 流 布 局 效果 
当然 由 于 水 果 名 字 的 长 度 每 次 都 是 随机 生成 的 ， 你 运行 时 的 效果 肯定 和 图 中 还 是 不 一 样 的 。 


7 


3.6.3 ”RecyclerView 的 点 击 事件 


和 ListView 一 样 ，RecyclerView 也 必须 要 能 响应 点 击 事件 才 可 以 , 不 然 的 话 就 没什么 实际 用 
途 了 。 不 过 不 同 于 ListView 的 是 , RecyclerView 并 没有 提供 类 似 于 set0nItemCLickListener() 
这 样 的 注册 监听 器 方法 ,而 是 需要 我 们 自己 给 子 项 具体 的 View 去 注册 点 击 事件 , 相 比 于 ListView 
来 说 ， 实 现 起 来 要 复杂 一 些 。 

那么 你 可 能 就 有 疑问 了 , 为 什么 RecyclerView 在 各 方面 的 设计 都 要 优 于 ListView, 偏偏 在 点 
击 事件 上 却 没 有 处 理 得 非常 好 呢 ? 其 实 不 是 这 样 的 ，ListView 在 点 击 事件 上 的 处 理 并 不 人 性 化 ， 
set0OnItemCLickListener() 方 法 注册 的 是 子 项 的 点 击 事件 , 但 如 果 我 想 点 击 的 是 子 项 里 具体 的 
某 一 个 按钮 呢 ? 虽然 ListView 也 是 能 做 到 的 ， 但 是 实现 起 来 就 相对 比较 麻烦 了 。 为 此 ， 


就 再 没有 这 个 困扰 了 。 

下 面 我 们 来 具体 学 习 一 下 如 何在 RecyclerView 中 注册 点 击 事件 ,修改 FruitAdapter 中 的 代 
码 ， 如 下 所 示 : 

public class FruitAdapter extends RecyclerView.Adapter<FruitAdapter.ViewHolder> { 


private List<Fruit> mFruitList; 
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static class ViewHolder extends RecyclerView.ViewHolder { 
View fruitView; 
ImageView fruitImage; 
TextView fruitName; 


public ViewHolder(View view) { 
super (view); 
fruitView = view; 


fruitImage = (ImageView) view.findViewById(R.id.fruit image); 
fruitName = (TextView) view.findViewById(R.id.fruit name); 


} 


public FruitAdapter(List<Fruit> fruitList) { 
mFruitList = fruitList， 


} 


GOverride 


public ViewHolder onCreateViewHolder(ViewGroup parent, int viewType) { 
View view = LayoutInflater.from(parent.getContext()).inflate(R.Tlayout. 


fruit item, parent, false); 
final ViewHolder holder = new ViewHolder (view); 


holder.fruitView.setOnClickListener(new View.0nCLickListener() { 


@Override 

public void onClick(View v) { 
int position = holder.getAdapterPosition(); 
Fruit fruit = mFruitList.get(position); 
Toast.makeText(v.getContext(), "you clicked view" 

Toast.LENGTH_ SHORT) .show() ; 
} 
}); 


+ fruit.getName(), 


holder.fruitImage.setOnClickListener(new View.0nCLickListener() { 


@Override 

public void onClick(View v) { 
int position = holder.getAdapterPosition(); 
Fruit fruit = mFruitList.get(position); 


Toast.makeText(v.getContext(), "you clicked image " + fruit.getName(), 


Toast.LENGTH_ SHORT) .show() ; 
} 
}); 
return holder; 


} 


我 们 先是 修改 了 ViewHolder, 在 ViewHolder 中 添加 了 fruitView 变量 来 保存 子 项 最 外 层 
布局 的 实例 , 然后 在 onCreateViewHolder() 方 法 中 注册 点 击 事件 就 可 以 了 。 这 里 分 别 为 最 外 层 
布局 和 ImageView 都 注册 了 点 击 事件 ，RecyclerView 的 强大 之 处 也 在 这 里 , 它 可 以 轻松 实现 子 项 


中 任意 控件 或 布局 的 点 击 事件 。 我 们 在 两 个 点 击 事件 中 先 获取 了 用 户 点 击 的 


position， 然 后 通过 


position 拿 到 相应 的 Fruit 实例 ， 再 使 用 Toast 分 别 弹出 两 种 不 同 的 内 容 以 示 


区 别 。 
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现在 重新 运行 代码 ， 并 点 击 香 熙 的 图 片 部 分 ,效果 如 图 3.37 所 示 。 可 以 看 到 ， 这 时 触发 了 


ImageView 的 点 击 事件 。 


然后 再 点 击 菠 葛 的 文字 部 分 ， 由 于 TextView 并 没有 注册 点 击 事件 ， 因 此 点 击 文字 这 


会 被 子 项 的 最 外 层 布局 捕获 到 ， 效 果 如 图 3.38 所 示 


0 下 1259 


RecyclerViewTest 


图 3.37 点 击 香 巷 的 图 片 部 分 


3.7 ”编写 界面 的 最 佳 实践 


0 


RecyclerViewTest 


图 3.38 点 


f 菠 更 的 文字 部 分 


习 


= 


事件 


既然 已 经 学 习 了 那么 多 UI 开发 的 知识 ， 也 是 时 候 实战 一 下 了 。 这 次 我 们 要 综合 运用 前 面 所 
学 的 大 量 内 容 来 编写 出 一 个 较为 复杂 且 相 当 美 观 的 聊天 界面 ， 你 准备 好 了 吗 ? 要 先 创 建 一 个 


UIBestPractice 项 目 才 算 准 备 好 了 哦 。 


3.7.1 制作 Nine-Patch 图 片 


在 实战 正式 开始 之 前 , 我 们 还 需要 先 学 习 一 下 如 何 制作 Nine-Patch 图 片 。 你 可 能 之 前 还 没有 
听 说 过 这 个 名 词 ， 它 是 一 种 被 特殊 处 理 过 的 png 图 片 ， 能 够 指定 哪些 区 域 可 以 被 拉 伸 、 哪 些 区 域 


不 可 以 。 


那么 Nine-Patch 图 片 到 底 有 什么 实际 作用 呢 ? 我 们 还 是 通过 一 个 例子 来 看 一 下 吧 。 比 如 说 项 
目 中 有 一 张 气泡 样式 的 图 片 message_ leftpng， 如 图 3.39 所 示 。 


图 3.39 ”气泡 术 


FE 式 
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我 们 将 这 张 图 片 设置 为 LinearLayout 的 背景 图 片 ， 修 改 activity_main.xml 中 的 代码 ， 如 下 
所 示 : 


<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:layout width="match parent" 
android:layout height="wrap content" 
android:background="@drawable/message left" 
> 

</LinearLayout> 


将 LinearLayout 的 宽度 指定 为 match_parent， 然 后 将 它 的 背景 图 设置 为 message left， 
现在 运行 程序 ， 效 果 如 图 3.40 所 示 。 
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图 3.40 气泡 被 均匀 拉 伸 的 效果 


可 以 看 到 , 由 于 message left 的 宽度 不 足以 填 满 整个 屏幕 的 宽度 , 整 张 图 片 被 均匀 地 拉 
伸 了 ! 这 种 效果 非常 差 , 用 户 肯定 是 不 能 容忍 的 ， 这 时 我 们 就 可 以 使 用 Nine-Patch 图 片 来 进行 
改善 。 

在 Android sdk 目录 下 有 一 个 tools 文件 夹 ， 在 这 个 文件 夹 中 找到 draw9patch.bat 文件 ， 我 们 
就 是 使 用 它 来 制作 Nine-Patch 图 片 的 。 不 过 , 要 打开 这 个 文件 ,必须 先 将 JDK 的 bin 目录 配置 到 
环境 变量 当中 才 行 ， 比 如 你 使 用 的 是 Android Studio 内 置 的 jdk, 那么 要 配置 的 路 径 就 是 <Android 
Studio 安装 目录 >/jre/bin。 如 果 你 还 不 知道 该 如 何 配置 环境 变量 , 可 以 先 去 参考 6.4.1 小 节 的 内 容 。 


双击 打开 draw9patch.bat 文件 ， 在 导航 栏 点 击 File 一 Open 9-patch 将 message_left.png 加 载 进 
来 ， 如 图 3.41 所 示 。 
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File 
Press Control/Shift while dragging on the border to nodify layout bounds. 


Zoom: 10% 一 一 | 一 一 一 一 一 一 一 一 800% 加 sho lock Show content 
Pateh scale: 2z| 一 一 一 一 一 一 tx。 回 sho patches [©]Show bad patches 
上 一 sr er 


图 3.41 使 用 draw9patch 编辑 message left 图 片 


我 们 可 以 在 图 片 的 四 个 边框 绘制 一 个 个 的 小 黑 点 , 在 上 边框 和 左边 框 绘制 的 部 分 表示 当 图 片 
需要 拉 伸 时 就 拉 伸 黑 点 标记 的 区 域 , 在 下 边框 和 右边 框 绘制 的 部 分 表示 内 容 会 被 放置 的 区 域 。 使 
用 鼠标 在 图 片 的 边缘 拖 动 就 可 以 进行 绘制 了 ， 按 住 Shift 键 拖 动 可 以 进行 擦 除 。 绘 制 完 成 后 效果 
如 图 3.42 所 示 。 


Zoon: 100 一 一 人 一 一 一 一 一 一 一 soox 加 sho lock Show content 
Patch scale 2 一 一 一 一 一 一 一 一 一 e 加 sho patches [| Show bad patches 
上 2 a 


图 3.42 ”绘制 完成 后 的 message_left 图 片 


最 后 点 击 导 航 栏 File 一 Save 9-patch 把 绘制 好 的 图 片 进 行 保存 ,此 时 的 文件 名 就 是 message_ 
left.9.png。 使 用 这 张 图 片 替换 掉 之 前 的 message_ left.png 图 片 ， 重 新 运行 程序 ， 效 果 如 图 3.43 
所 示 。 
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图 3.43 气泡 只 拉 伸 绘制 区 域 的 效果 


这 样 当 图 片 需要 拉 伸 的 时 候 ， 就 可 以 只 拉 伸 指定 的 区 域 ,程序 在 外 观 上 也 有 了 很 大 的 改进 。 
有 了 这 个 知识 储备 之 后 ， 我 们 就 可 以 进入 实战 环节 了 。 


3.7.2 ”编写 精美 的 聊天 表面 


既然 是 要 编写 一 个 聊天 界面 , 那 就 肯定 要 有 收 到 的 消息 和 发 出 的 消息 。 上 一 节 中 我 们 制作 的 
message_left.9.png 可 以 作为 收 到 消息 的 背景 图 ， 那 么 毫 无 疑问 你 还 需要 再 制作 一 张 message_ 
right.9.png 作为 发 出 消息 的 背景 图 。 

图 片 都 提供 好 了 之 后 就 可 以 开始 编码 了 。 由 于 待 会 我 们 会 用 到 RecyclerView， 因 此 首先 需要 
在 app/build.gradle 当中 添加 依赖 库 ， 如 下 所 示 : 


dependencies { 
compile fileTree(dir: 'libs', include: ['*.jar']) 
compile 'com.android,.support:appcompat-v7:24.2.1" 
compile 'com.android.support:recyclerview-v7:24.2.1' 
testCompile 'junit:junit:4.12， 


} 
接 下 来 开始 编写 主 界面 ， 修 改 activity_main.xml 中 的 代码 ， 如 下 所 示 : 


<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:orientation="vertical" 
android:layout width="match parent" 
android:layout height="match parent" 
android:background="#d8e0e8" > 


<android.support.v7.widget.RecyclerView 
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android:id="@+id/msg recycler view" 
android:layout width="match parent" 
android:layout height="0Qdp" 
android:layout weight="1" /> 


<LinearLayout 
android:layout width="match parent" 
android:layout height="wrap content" > 


<EditText 
android:id="@+id/input text" 
android:Layout width="0dp" 
android:layout height="wrap content" 
android:Layout weight="1" 
android:hint="Type something here" 
android:maxLines="2" /> 


<Button 
android:id="@+id/send" 
android:layout width="wrap_content" 
android:layout height="wrap content" 
android:text="Send" /> 


</LinearLayout> 
</LinearLayout> 


我 们 在 主 界面 中 放置 了 一 个 RecyclerView 用 于 显示 聊天 的 消息 内 容 ， 又 放置 了 一 个 EditText 
用 于 输入 消息 ， 还 放置 了 一 个 Button 用 于 发 送 消 息 。 这 里 用 到 的 所 有 属性 都 是 我 们 之 前 学 过 的 ， 
相信 你 理解 起 来 应 该 不 费力 。 

然后 定义 消息 的 实体 类 ， 新 建 Msg， 代 码 如 下 所 示 : 

public class Msg { 


public static final int TYPE RECEIVED = 0; 
public static final int TYPE SENT = 1; 
private String content; 
private int type; 
public Msg(String content, int type) { 
this.content = content; 
this.type = type; 
} 
public String getContent() { 
return content; 


} 


public int getType() { 
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return type; 


} 


Msg 类 中 只 有 两 个 字段 ，content 表示 消息 的 内 容 , type 表示 消息 的 类 型 。 其 中 消息 类 型 
有 两 个 值 可 选 ，TYPE_RECEIVED 表示 这 是 一 条 收 到 的 消息 ，TYPE_SENT 表示 这 是 一 条 发 出 的 
消息 。 

接着 来 编写 RecyclerView 子 项 的 布局 ， 新 建 msg_item.xml， 代 码 如 下 所 示 : 


<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:orientation="vertical" 
android:layout width="match parent" 
android:layout height="wrap_ content" 
android:padding="10dp” > 


<LinearLayout 
android:id="@+id/left layout" 
android:layout width="wrap_content" 
android:layout height="wrap_ content" 
android:layout gravity="left" 
android:background="@drawable/message left" > 


<TextView 
android:id="@+id/left msg" 
android:layout width="wrap content" 
android:layout height="wrap content" 
android:layout gravity="center" 
android:layout margin="10dp" 
android:textColor="#fff" /> 


</LinearLayout> 


<LinearLayout 
android:id="@+id/right layout" 
android:layout width="wrap content" 
android:layout height="wrap content" 
android:layout gravity="right" 
android:background="@drawable/message right" > 


<TextView 
android:id="@+id/right msg" 
android:layout width="wrap_ content" 
android:layout height="wrap content" 
android:layout gravity="center" 
android:layout margin="1l0dp" /> 


</LinearLayout> 


</LinearLayout> 


这 里 我 们 让 收 到 的 消息 居 左 对 齐 ， 发 出 的 消息 居 右 对 齐 ， 并 且 分 别 使 用 message_left.9.png 和 
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message_right.9.png 作为 背景 图 。 你 可 能 会 有 些 疑 虑 ， 怎 么 能 让 收 到 的 消息 和 发 出 的 消息 都 放 在 
同一 个 布局 里 呢 ? 不 用 担心 , 还 记得 我 们 前 面 学 过 的 可 见 属性 吗 ? 只 要 稍 后 在 代码 中 根据 消息 的 
类 型 来 决定 隐藏 和 显示 哪 种 消息 就 可 以 了 。 
接 下 来 需要 创建 RecyclerView 的 适配器 类 ， 新 建 类 MsgAdapter ， 代 码 如 下 所 示 : 


public cLass MsgAdapter extends RecyclerView.Adapter<MsgAdapter.ViewHolder> { 


型 


private List<Msg> mMsgList; 
static class ViewHolder extends RecyclerView.ViewHolder { 
LinearLayout leftLayout; 
LinearLayout rightLayout; 
TextView leftMsg; 
TextView rightMsg; 


public ViewHolder(View view) { 
super (view); 
leftLayout = (LinearLayout) view.findViewById(R.id.left layout); 
rightLayout = (LinearLayout) view.findViewById(R.id.right layout); 
LeftMsg = (TextView) view.findViewById(R.id.left msg); 
rightMsg = (TextView) view.findViewById(R.id.right msg); 


} 


public MsgAdapter(List<Msg> msgList) { 
mMsgList = msgList; 
} 


@Override 
public ViewHolder onCreateViewHolder(ViewGroup parent, int viewType) { 
View view = LayoutInflater.from(parent.getContext()).inflate 
(R.layout.msg item, parent, false); 
return new ViewHolder (view); 


} 


@Override 
public void onBindViewHolder(ViewHolder holder, int position) { 
Msg msg = msgl List get(position), 
if (msg.getType() == Msg.TYPE RECEIVED) { 
// 如 果 是 收 到 的 消息 ， 则 显示 左 这 的 消息 布局 ， 将 右边 的 消息 布局 隐藏 
holder.leftLayout.setVisibility(View.VISIBLE); 
holder.rightLayout.setVisibility(View.GONE); 
holder -lettMsg:.setText(msgageteontent())s 
} else if(msg.getType() == Msg.TYPE SENT) { 
// 如 果 是 发 出 的 消息 ， 则 显示 右边 的 消息 布局 ， 将 左边 的 消息 布局 隐藏 
holder.rightLayout.setVisibility(View.VISIBLE); 
holder.leftLayout.setVisibility(View.GONE); 
holder.rightMsg.setText(msg.getContent()); 
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} 


GOverride 
public int getItemCount() { 
return mMsgList.size()，; 


} 
} 
以 上 代码 你 应 该 非常 熟悉 了 ,和 我 们 学 习 RecyclerView 那 一 节 的 代码 基本 是 一 样 的 ,只 不 过 
在 onBindViewHolder() 方 法 中 增加 了 对 消息 类 型 的 判断 。 如 果 这 条 消息 是 收 到 的 , 则 显示 左边 
的 消息 布局 ， 如 果 这 条 消息 是 发 出 的 ， 则 显示 右边 的 消息 布局 。 
最 后 修改 MainActivity 中 的 代码 , 来 为 RecyclerView 初始 化 一 些 数据 ,并 给 发 送 按钮 加 入 奸 
件 响 应 ， 代 码 如 下 所 示 


public class MainActivity extends AppCompatActivity { 


ny 


private List<Msg> msgList = new ArrayList<>(); 
private EditText inputText; 

private Button send; 

private RecyclerView msgRecyclerView; 

private MsgAdapter adapter; 


@Override 
protected void onCreate(Bundle savedInstanceState) { 

super.onCreate(savedInstanceState); 

setContentView(R.layout.activity main); 

initMsgs(); // 初始 化 消息 数据 

inputText = (EditText) findViewById(R.id.input text); 

send = (Button) findViewById(R.id.send); 

msgRecyclerView = (RecyclerView) findViewById(R.id.msg recycler view); 

LinearLayoutManager LayoutManager = new LinearLayoutManager (this); 

msgRecyclerView.setLayoutManager (layoutManager); 

adapter = new MsgAdapter(msgList); 

msgRecyclerView,.setAdapter(adapter); 

send.setOnClickListener(new View.0nCLickListener() { 

@Override 
public void onClick(View v) { 
String content = inputText.getText().toString(); 
if (!"".equals(content)) { 

Msg msg = new Msg(content, Msg.TYPE SENT); 
msgList.add(msg) ; 
adapter.notifyItemInserted(msgList.size() - 1); // 当 有 新 消息 时 ， 
刷新 RecyclerView 中 的 显示 
msgRecyclerView.scrollToPosition(msgList.size() - 1); // 将 
RecyclerView 定位 到 最 后 一 行 
inputText.setText(""); // 清空 输入 框 中 的 内 容 
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} 
} 
}); 
} 


private void initMsgs() { 
Msg msgl = new Msg("Hello guy.", Msg.TYPE RECEIVED); 
msgList.add(msg1); 
Msg msg2 = new Msg("Hello. Who is that?", Msg.TYPE SENT); 
msgList.add(msg2); 
Msg msg3 = new Msg("This is Tom. Nice talking to you. ", Msg.TYPE RECEIVED); 
msgList.add(msg3); 


} 


在 initMsgs() 方 法 中 我 们 先 初 始 化 了 几 条 数据 用 于 在 RecyclerView 中 显示 。 然后 在 发 送 按 
钮 的 点 击 事件 里 获取 了 EditText 中 的 内 容 ， 如 果 内 容 不 为 空 字符 串 则 创建 出 一 个 新 的 Msg 对 象 ， 
并 把 它 添加 到 msgList 列表 中 去 。 之 后 又 调用 了 适 配 胡 的 notifyItemInserted () 方 法 ， 用 于 通 
知 列表 有 新 的 数据 插入 ， 这 样 新 增 的 一 条 消息 才能 够 在 RecyclerView 中 显示 。 接 着 调用 
RecyclerView 的 scroLLToPosition() 方 法 将 显示 的 数据 定位 到 最 后 一 行 , 以 保证 一 定 可 以 看 得 
到 最 后 发 出 的 一 条 消息 。 最 后 调用 EditText 的 setText ( ) 方 法 将 输入 的 内 容 清空 。 

这 样 所 有 的 工作 就 都 完成 了 , 终于 可 以 检验 一 下 我 们 的 成 果 了 ,运行 程序 之 后 你 将 会 看 到 非 
党 美观 的 聊天 界面 ， 并 且 可 以 输入 和 发 送 消息 ， 如 图 3.44 所 示 。 
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This is Tom Nice talking to you. 


Sure SEND 


本 O 口 
图 3.44 ”精美 的 聊天 界面 


相信 这 个 例子 的 实战 过 程 不 仅 加 深 了 你 对 本 章 中 所 学 UI 知识 的 理解 ， 还 让 你 有 了 如 何 灵活 
运用 这 些 知 识 来 设计 出 优秀 界面 的 思路 。 这 一 章 也 是 学 了 不 少 东西 ， 让 我 们 来 总 结 一 下 吧 。 
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3.8 小 结 与 点 评 


虽然 本 章 的 内 容 很 多 , 但 我 觉得 学 习 起 来 应 该 还 是 挺 愉快 的 吧 。 不同 于 上 一 章 中 我 们 来 来 回 
回 使 用 那 几 个 按钮 ， 本 章 可 以 说 是 使 用 了 各 种 各 样 的 控件 ,制作 出 了 丰富 多 彩 的 界面 。 尤 其 是 在 
实战 环节 ， 编 写 出 了 那么 精美 的 聊天 界面 ， 你 的 满足 感应 该 比 上 一 章 还 要 强 吧 ? 

本 章 从 Android 中 的 一 些 常 见 控件 开始 人 手 ， 依 次 介绍 了 基本 布局 的 用 法 、 自 定义 控件 的 方 
法 、ListView 的 详细 用 法 以 及 RecyclerView 的 使 用 ， 基 本 已 经 将 重要 的 UI 知识 点 全 部 覆盖 了 。 
想 想 在 开始 的 时 候 我 说 不 推荐 使 用 可 视 化 的 编辑 工具 ， 而 是 应 该 全 部 使 用 XML 的 方式 来 编写 界 
面 ， 现 在 你 是 不 是 已 经 感觉 使 用 XML 非常 简单 了 呢 ?” 以 后 不 管 面 对 多 么 复杂 的 界面 ， 我 希望 你 
都 能 够 自信 满 满 ， 因 为 真正 理解 了 界面 编写 的 原理 之 后 ， 是 没有 什么 能 够 难得 倒 你 的 。 

不 过 到 目前 为 止 ， 我 们 还 只 是 学 习 了 Android 手机 方面 的 开发 技巧 ， 下 一 章 将 会 涉及 一 些 
Android 平 板 方面 的 知识 点 ,能够 同时 兼容 手机 和 平板 也 是 自 Android 4.0 系统 开始 就 支持 的 特性 。 
适当 地 放松 和 休息 一 段 时 间 后 ， 我 们 再 来 继续 前 行 吧 ! 
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手机 平板 要 兼顾 一 一 探究 碎片 


当今 是 移动 设备 发 展 非常 迅速 的 时 代 , 不 仅 手机 已 经 成 为 了 生活 必需 品 , 就 连 平板 电脑 也 变 
得 越 来 越 普 及 。 平板 电脑 和 手机 最 大 的 区 别 就 在 于 屏幕 的 大 小 , 一 般 手机 屏幕 的 大 小 会 在 3 英寸 
到 6 英寸 之 间 ， 而 一 般 平板 电脑 屏幕 的 大 小 会 在 7 英寸 到 10 英寸 之 间 。 屏 幕 大 小 差距 过 大 有 可 
能 会 让 同样 的 界面 在 视觉 效果 上 有 较 大 的 差异 ， 比 如 一 些 界 面 在 手机 上 看 起 来 非常 美观 , 但 在 平 
板 电脑 上 看 起 来 就 可 能 会 有 控件 被 过 分 拉 长 、 元 素 之 间 空 阶 过 大 等 情况 。 

作为 一 名 专业 的 Android 开发 人 员 ,能 够 同时 兼顾 手机 和 平板 的 开发 是 我 们 必须 做 到 的 事情 。 
Android 自 3.0 版 本 开始 引入 了 碎片 的 概念 ， 它 可 以 让 界面 在 平板 上 更 好 地 展示 ， 下 面 我 们 就 来 一 
起 学 习 一 下 。 


4.1 碎片 是 什么 


碎片 (Fragment ) 是 一 种 可 以 人 诗人 在 活动 当中 的 UI 片段 ， 它 能 让 程序 更 加 合理 和 充分 地 利 
用 大 屏幕 的 空间 ， 因 而 在 平板 上 应 用 得 非常 广泛 。 虽然 碎片 对 你 来 说 应 该 是 个 全 新 的 概念 ,但 我 
相信 你 学 习 起 来 应 该 毫 不 费力 ， 因 为 它 和 活动 实在 是 太 像 了 ,同样 都 能 包含 布局 ,同样 都 有 自己 
的 生命 周期 。 你 甚至 可 以 将 碎片 理解 成 一 个 迷你 型 的 活动 , 虽然 这 个 迷你 型 的 活动 有 可 能 和 普通 
的 活动 是 一 样 大 的 。 

那么 究竟 要 如 何 使 用 碎片 才能 充分 地 利用 平板 屏幕 的 空间 呢 ? 想象 我 们 正在 开发 一 个 新 闻 
应 用 , 其 中 一 个 界面 使 用 RecyclerView 展示 了 一 组 新 闻 的 标题 ， 当 点 击 了 其 中 一 个 标题 时 ， 就 打 
开 男 一 个 界面 显示 新 闻 的 详细 内 容 。 如 果 是 在 手机 中 设计 , 我 们 可 以 将 新 闻 标 题 列表 放 在 一 个 活 
动 中 ， 将 新 闻 的 详细 内 容 放 在 男 一 个 活动 中 ， 如 图 4.1 所 示 。 


图 4.1 手机 的 设计 方案 


可 是 如 果 在 平板 上 也 这 么 设计 , 那么 新 闻 标 题 列表 将 会 被 拉 长 至 填充 满 整个 平板 的 屏幕 ， 而 
新 闻 的 标题 一 般 都 不 会 太 长 ， 这 样 将 会 导致 界面 上 有 大 量 的 空白 区 域 ， 如 网 4.2 所 示 。 


图 4.2 平板 的 新 闻 列表 


因此 ,更 好 的 设计 方案 是 将 新 闻 标 题 列 表 界 面 和 新 闻 详 细 内 容 界面 分 别 放 在 两 个 碎片 中 ， 
然后 在 同一 个 活动 里 引入 这 两 个 碎片 ， 这 样 就 可 以 将 屏幕 空间 充分 地 利用 起 来 了 ， 如 图 4.3 
所 示 。 
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图 4.3 平板 的 双 页 设计 


4.2 ”碎片 的 使 用 方式 


介绍 了 这 么 多 抽象 的 东西 ,也 是 时 候 学 习 一 下 碎片 的 具体 用 法 了 。 你 已 经 知道 , 碎片 通常 都 
是 在 平板 开发 中 使 用 的 ,因此 我 们 首先 要 做 的 就 是 创建 一 个 平板 模拟 器 。 创 建 模拟 器 的 方法 我 们 
在 第 1 章 已 经 学 过 了 ， 创 建 完 成 后 启动 平板 模拟 器 ， 效 果 如 图 4.4 所 示 。 


图 4.4 平板 模拟 器 的 运行 效果 


好 了 ,准备 工作 都 完成 了 ， 接 着 新 建 一 个 FragmentTest 项目 ,然后 开始 我 们 的 碎片 探索 之 
旅 吧 。 


4.2.1 碎片 的 简单 用 法 
这 里 我 们 准备 先 写 一 个 最 简单 的 碎片 示例 来 练 练 手 , 在 一 个 活动 当中 添加 两 个 碎片 ,并 让 这 
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两 个 碎片 平分 活动 空间 。 


新 建 一 个 左 侧 碎片 布局 left fragment.xml， 代 码 如 下 所 示 : 


<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:orientation="vertical" 
android:layout width="match parent" 
android:layout height="match parent"> 


<Button 
android:id="@+id/button" 

android:layout width="wrap content" 
android:layout height="wrap content" 
android:layout gravity="center horizontal" 
android:text="Button" 


/> 


</LinearLayout> 


这 个 布局 非常 简单 ， 只 放 
right_fragment.xml， 代 码 如 下 所 示 : 


置 了 一 个 按钮 ， 并 让 它 水 平 居中 显示 。 然 后 新 建 右 侧 碎片 布局 


<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:orientation="vertical" 
android:background="#00ff00" 
android:layout width="match parent" 
android:layout height="match parent"> 


<TextView 
android:layout width="wrap_ content" 
android:layout height="wrap content" 
android:layout gravity="center horizontal" 
android:textSize="20sp" 

android:text="This is right fragment" 


/> 


</LinearLayout> 


可 以 看 到 ， 我 们 将 这 个 布局 的 背景 色 设置 成 了 绿色 ， 并 放置 了 一 个 TextView 用 于 显示 一 段 


文本 。 


接着 新 建 一 个 LeftFragment 类 , 并 让 它 继承 自 Fragment。 注意, 这 里 可 能 会 有 两 个 不 同 包 


下 的 Fragment 供 你 选择 ， 


一 个 是 系统 内 置 的 android.app.Fragment， 一 个 是 support-v4 库 中 的 


android.support.v4.app.Fragment。 这 里 我 强烈 建议 你 使 用 support-v4 库 中 的 Fragment， 因 为 它 可 
以 让 碎片 在 所 有 Android 系统 版 本 中 保持 功能 一 致 性 。 比 如 说 在 Fragment 中 髓 套 使 用 Fragment， 
这 个 功能 是 在 Android 4.2 系统 中 才 开 始 支 持 的 ， 如 果 你 使 用 的 是 系统 内 置 的 Fragment， 那 么 很 
遗憾 ，4.2 系统 之 前 的 设备 运行 你 的 程序 就 会 月 溃 。 而 使 用 support-v4 库 中 的 Fragment 就 不 会 出 


现 这 个 问题 ， 


只 要 你 保证 使 月 


上 的 是 最 新 的 support-v4 库 就 可 以 了 。 另 外 ， 我 们 并 不 需要 在 


build.gradle 文件 中 添加 support-v4 库 的 依赖 ， 因 为 build.gradle 文件 中 已 经 添加 了 appcompat-v7 


六 


146 第 4 章 手机 平板 要 兼顾 一 一 探究 碎片 


库 的 依赖 ， 而 这 个 库 会 将 support-v4 库 也 一 起 引入 进来 。 
现在 编写 一 下 LeftFragment 中 的 代码 ， 如 下 所 示 : 


public class LeftFragment extends Fragment { 


@Override 
public View onCreateView(LayoutInfLater inflater, ViewGroup container， 
Bundle savedInstanceState) { 
View view = inflater.inflate(R.layout.left fragment, container, false); 
return view; 


} 


这 里 仅仅 是 重 写 了 Fragment 的 onCreateView( ) 方 法 ， 然 后 在 这 个 方法 中 通过 LayoutInflater 
的 inflate() 方 法 将 刚才 定义 的 left_ fragment 布局 动态 加 载 进来 ,整个 方法 简单 明了 。 接着 我 们 
用 同样 的 方法 再 新 建 一 个 RightFragment ， 代 码 如 下 所 示 : 


public class RightFragment extends Fragment { 


@Override 
public View onCreateView(LayoutInfLater inflater, ViewGroup container, 
Bundle savedInstanceState) { 
View view = inflater.inflate(R.layout.right fragment, container, false); 
return view; 


} 


基本 上 代码 都 是 相同 的 ， 相 信 已 经 没有 必要 再 做 什么 解释 了 。 接 下 来 修改 activity_main.xml 
中 的 代码 ， 如 下 所 示 : 


<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:orientation="horizontal" 
android:layout width="match parent" 
android:layout height="match parent" > 


<fragment 
android:id="@+id/left fragment" 
android:name="com.example.fragmenttest.LeftFragment" 
android:Layout width="0dp" 
android:Layout height="match parent" 
android:layout weight="1" /> 


<fragment 
android:id="@+id/right fragment" 
android:name="com.example.fragmenttest.RightFragment" 
android:Layout width="0dp" 
android:layout height="match parent" 
android:layout weight="1" /> 


</LinearLayout> 
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可 以 看 到 ， 我 们 使 用 了 <fragment> 标 签 在 布局 中 添加 碎片 ， 其 中 指定 的 大 多 数 属性 都 是 你 
熟悉 的 ， 只 不 过 这 里 还 需要 通过 android:name 属性 来 显 式 指明 要 添加 的 碎片 类 名 , 注意 一 定 要 
将 类 的 包 名 也 加 上 。 

这 样 最 简单 的 碎片 示例 就 已 经 写 好 了 ， 现 在 运行 一 下 程序 ， 效 果 如 图 4.5 所 示 。 


FragmentTest 


图 4.5 碎片 的 简单 运行 效果 


正如 我 们 所 期 待 的 一 样 ， 两 个 碎片 平分 了 整个 活动 的 布局 。 不 过 这 个 例子 实在 是 太 简 单 了 ， 
在 真正 的 项 目 中 很 难 有 什么 实际 的 作用 , 因此 我 们 马上 来 看 一 看 , 关于 碎片 更 加 高 级 的 使 用 技巧 。 


4.2.2 ”动态 添加 人 碎片 


在 上 一 节 当 中 ,你 已 经 学 会 了 在 布局 文件 中 添加 碎片 的 方法 ,不 过 碎片 真正 的 强大 之 处 在 于 ， 
它 可 以 在 程序 运行 时 动态 地 添加 到 活动 当中 。 根据 具体 情况 来 动态 地 添加 碎片 , 你 就 可 以 将 程序 
界面 定制 得 更 加 多 样 化 。 

我 们 还 是 在 上 一 节 代 码 的 基础 上 继续 完善 , 新 建 another_right_fragment.xml, 代码 如 下 所 示 : 


<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:orientation="vertical" 
android:background="#ffff00" 
android:layout width="match parent" 
android:layout height="match parent"> 


<TextView 
android:layout width="wrap content" 
android:layout height="wrap content" 
android:layout gravity="center horizontal" 
android:textSize="20sp" 
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android:text="This is another right fragment" 
/> 


</LinearLayout> 


这 个 布局 文件 的 代码 和 right_fragment.xml 中 的 代码 基本 相同 ， 只 是 将 背景 色 改 成 了 黄色 ， 并 
将 显示 的 文字 改 了 改 。 然 后 新 建 AnotherRightFragment 作为 另 一 个 右 侧 碎片 ， 代 码 如 下 所 示 


public class AnotherRightFragment extends Fragment { 


@Override 
public View onCreateView(LayoutInflater inflater, ViewGroup container, 
Bundle savedInstanceState) { 
View view = inflater.inflate(R.layout.another right fragment, container, 
false); 
return view; 


} 


代码 同样 非常 简单 , 在 onCreateView() 方 法 中 加 载 了 刚刚 创建 的 another_right_fragment 布 
局 。 这 样 我 们 就 准备 好 了 男 一 个 碎片 ， 接 下 来 看 一 下 如 何 将 它 动 态 地 添加 到 活动 当中 。 修 改 
activity_main.xml， 代 码 如 下 所 示 : 


<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:orientation="horizontal" 
android:layout width="match parent" 
android:layout height="match parent" > 


<fragment 
android:id="@+id/left fragment" 
android:name="com.example.fragmenttest.LeftFragment" 
android:Layout width="0dp" 
android:layout height="match parent" 
android:layout weight="1" /> 


<FrameLayout 
android:id="@+id/right layout" 
android:layout width="0Qdp" 
android:layout height="match _ parent" 
android:layout weight="1" > 
</FrameLayout> 


</LinearLayout> 

可 以 看 到 ,现在 将 右 侧 碎 片 替 换 成 了 一 个 FrameLayout 中 , 还 记得 这 个 布局 吗 ? 在 上 一 章 中 
我 们 学 过 ,这 是 Android 中 最 简单 的 一 种 布局 ， 所 有 的 控件 默认 都 会 摆 放 在 布局 的 左上 角 。 由 于 
这 里 仅 需要 在 布局 里 放 和 一 个 碎片 ， 不 需要 任何 定位 ， 因 此 非常 适合 使 用 FrameLayout。 


下 面 我 们 将 在 代码 中 向 FrameLayout 里 添加 内 容 ， 从 而 实现 动态 添加 碎片 的 功能 。 修 改 
MainActivity 中 的 代码 ， 如 下 所 示 : 
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public class MainActivity extends AppCompatActivity impLements View.OnClickListener { 


GOverride 

protected void onCreate(Bundle savedInstanceState) { 
super.onCreate(savedInstanceState); 
setContentView(R.layout.activity main); 
Button button = (Button) findViewById(R.id.button); 
button.setOnClickListener (this); 
replaceFragment (new RightFragment()); 

} 


@Override 
public void onClick(View v) { 
Switch (v.getId()) { 
case R.id.button: 
replaceFragment (new AnotherRightFragment()); 
break; 
default: 
break; 


} 


private void replaceFragment(Fragment fragment) { 
FragmentManager fragmentManager = getSupportFragmentManager(); 
FragmentTransaction transaction = fragmentManager.beginTransaction(); 
transaction.replace(R.id.right layout, fragment); 
transaction.commit(); 


} 
} 
可 以 看 到 ， 首 先 我 们 给 左 侧 碎 片 中 的 按钮 注册 了 一 个 点 击 事件 ， 然 后 调用 
replaceFragment() 方 法 动态 添加 了 RightFragment 这 个 碎片 。 当 点 击 左 侧 碎 片 中 的 按钮 时 ， 又 


会 调用 repLaceFragment() 方法 将 右 侧 碎片 替换 成 AnotherRightFragment 。 结 合 
replaceFragment() 方 法 中 的 代码 可 以 看 出 ， 动 态 添加 碎片 主要 分 为 5 步 。 

(1) 创建 竺 添加 的 碎片 实例 。 

(2) 获取 FragmentManager, 在 活动 中 可 以 直接 通过 调用 getSupportFragmentManager() 方 
法 得 到 。 


(3) 开启 一 个 事务 ， 通 过 调用 beginTransaction( ) 方 法 开启 。 

(4) 向 容器 内 添加 或 蔡 换 碎片 ， 一 般 使 用 replace() 方 法 实现 ， 需要 传人 容器 的 id 和 待 添加 
的 碎片 实例 。 

(5) 提交 事务 ， 调 用 commit ( ) 方 法 来 完成 。 

这 样 就 完成 了 在 活动 中 动态 添加 碎片 的 功能 ， 重 新 运行 程序 ， 可 以 看 到 和 之 前 相同 的 界面 ， 


然后 点 击 一 下 按钮 ， 效 果 如 图 4.6 所 示 。 
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4.2.3 在 碎 


301 
FragmentTest 


This is another right fragment 


4 [© 口 


图 4.6 动态 添加 碎片 的 效果 


片 中 模拟 返回 栈 


在 上 一 小 节 中 ， 我 们 成 功 实现 了 向 活动 中 动态 添加 碎片 的 功能 ， 不 过 你 尝试 一 下 就 会 发 现 ， 
通过 点 击 按钮 添加 了 一 个 碎片 之 后 ， 这 时 按 下 Back 键 程序 就 会 直接 退出 。 如 果 这 里 我 们 想 模 仿 


类 似 于 返回 栈 的 效果 ， 按 下 Back 键 可 以 回 到 上 一 个 碎片 ， 该 如 何 实现 呢 ? 


其 实 很 简单 ，FragmentTransaction 中 提供 了 一 个 addToBackStack() 方 法 ， 可 以 用 于 将 一 个 


是 


事务 添加 到 返 返回 栈 中 ， 修 改 MainActivity 中 的 代码 ， 如 下 所 示 : 


public cLass MainActivity extends AppCompatActivity impLements View.0nCLickListener { 


private void repLaceFragment(Fragment fragment) { 


} 


FragmentManager fragmentManager = getSupportFragmentManager(); 
FragmentTransaction transaction = fragmentManager.beginTransaction(); 
transaction.replace(R.id,.right layout, fragment); 
transaction.addToBackStack (null); 

transaction.commit(); 


这 里 我 们 在 事务 提交 之 前 调用 了 FragmentTransaction 的 addToBackStack() 方 法 , 它 可 以 接 


收 一 个 名 字 朋 


日 于 描述 返回 栈 的 状态 ， 一 般 传 入 nuLL 即 可 。 现 在 重新 运行 程序 ， 并 点 击 按钮 将 


AnotherRightFragment 添加 到 活动 中 ,然后 按 下 Back 键 ， 你 会 发 现 程序 并 没有 退出 ， 而 是 回 到 了 
RightFragment 界面 ， 继 续 按 下 Back 键 ，RightFragment 界面 也 会 消失 ， 再 次 按 下 Back 键 ， 程 序 


才 会 退出 。 
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4.2.4 ”碎片 和 活动 之 间 进 行 通 信 
虽然 碎片 都 是 嵌入 在 活动 中 显示 的 ， 可 是 实际 上 它们 的 关系 并 没有 那么 亲密 。 你 可 以 看 出 ， 
碎片 和 活动 都 是 各 自 存在 于 一 个 独立 的 类 当中 的 , 它们 之 间 并 没有 那么 明显 的 方式 来 直接 进行 通 
信 。 如 果 想 要 在 活动 中 调用 碎片 里 的 方法 ,或 者 在 碎片 中 调用 活动 里 的 方法 ,应 该 如 何 实现 呢 ? 
为 了 方便 碎片 和 活动 之 间 进 行 通信 ，FragmentManager 提供 了 一 个 类 似 于 findViewById() 
的 方法 ， 专 门 用 于 从 布局 文件 中 获取 碎片 的 实例 ， 代 码 如 下 所 示 : 


RightFragment rightFragment = (RightFragment) getSupportFragmentManager() 
.findFragmentById(R.id.right fragment); 


调用 FragmentManager 的 findFragmentById () 方 法 ， 可 以 在 活动 中 得 到 相应 碎片 的 实例 ， 
然后 就 能 轻松 地 调用 碎片 里 的 方法 了 。 
掌握 了 如 何在 活动 中 调用 碎片 里 的 方法 , 那 在 碎片 中 又 该 怎样 调用 活动 里 的 方法 呢 ? 其 实 这 
就 更 简单 了 ， 在 每 个 碎片 中 都 可 以 通过 调用 getActivity() 方 法 来 得 到 和 当前 碎片 相关 联 的 活 
动 实例 ， 代 码 如 下 所 示 : 

MainActivity activity = (MainActivity) getActivity(); 

有 了 活动 实例 之 后 , 在 碎片 中 调用 活动 里 的 方法 就 变 得 轻而易举 了 。 另 外 当 碎 片 中 需要 使 用 
Context 对 象 时 ， 也 可 以 使 用 getActivity() 方 法 ， 因 为 获取 到 的 活动 本 身 就 是 一 个 Context 
对 象 。 

这 时 不 知道 你 心中 会 不 会 产生 一 个 疑问 : 既然 碎片 和 活动 之 间 的 通信 问题 已 经 解决 了 , 那么 
碎片 和 碎片 之 间 可 不 可 以 进行 通信 呢 ? 

说 实在 的 ,这 个 问题 并 没有 看 上 去 那么 复杂 , 它 的 基本 思路 非常 简单 ， 首 先 在 一 个 碎片 中 可 
以 得 到 与 它 相 关联 的 活动 , 然后 再 通过 这 个 活动 去 获取 另外 一 个 碎片 的 实例 , 这 样 也 就 实现 了 不 
同 碎片 之 间 的 通信 功能 ， 因 此 这 里 我 们 的 答案 是 肯定 的 。 


4.3 ”碎片 的 生命 周期 


和 活动 一 样 , 碎片 也 有 自己 的 生命 周期 , 并 且 它 和 活动 的 生命 周期 实在 是 太 像 了 , 我 相信 你 
很 快 就 能 学 会 ， 下 面 我 们 马上 就 来 看 一 下 。 


4.3.1 ”碎片 的 状态 和 回调 


还 记得 每 个 活动 在 其 生命 周期 内 可 能 会 有 哪儿 种 状态 吗 ? 没 错 ,一 共有 运行 状态 、 暂 停 状 态 、 
停止 状态 和 销毁 状态 这 4 种 。 类 似 地 ,每 个 碎片 在 其 生命 周期 内 也 可 能 会 经 历 这 儿 种 状态 ,只 不 
过 在 一 些 细小 的 地 方 会 有 部 分 区 别 。 
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1. 运行 状态 

当 一 个 碎片 是 可 见 的 ， 并 且 它 所 关联 的 活动 正 处 于 运行 状态 时 ， 该 碎片 也 处 于 运行 状态 。 

2. 暂停 状态 

当 一 个 活动 进入 暂停 状态 时 ( 由 于 另 一 个 未 占 满 屏 幕 的 活动 被 添加 到 了 栈 顶 )， 与 它 相 关联 
的 可 见 碎片 就 会 进入 到 暂停 状态 。 

3. 停止 状态 

当 一 个 活动 进入 停止 状态 时 ， 与 它 相 关联 的 碎片 就 会 进入 到 停止 状态 ， 或 者 通过 调用 
FragmentTransaction 的 remove()、replace() 方 法 将 碎片 从 活动 中 移 除 ， 但 如 果 在 事务 提交 之 
前 调用 addToBackStack() 方 法 ， 这 时 的 碎片 也 会 进入 到 停止 状态 。 总 的 来 说 ， 进 入 停止 状态 的 
雄 片 对 用 户 来 说 是 完全 不 可 见 的 ， 有 可 能 会 被 系统 回收 。 

4. 销毁 状态 

碎片 总 是 依附 于 活动 而 存在 的 , 因此 当 活 动 被 销毁 时 , 与 它 相 关联 的 碎片 就 会 进入 到 销毁 状 
态 。 或 者 通过 调用 FragmentTransaction 的 remove( ) 、repLace() 方 法 将 碎片 从 活动 中 移 除 ， 但 
在 事务 提交 之 前 并 没有 调用 addToBackStack() 方 法 ， 这 时 的 碎片 也 会 进入 到 销毁 状态 。 

结合 之 前 的 活动 状态 ， 相 信 你 理解 起 来 应 该 毫 不 费力 吧 。 同 样 地 ，Fragment 类 中 也 提供 了 
一 系列 的 回调 方法 ， 以 覆盖 碎片 生命 周期 的 每 个 环节 。 其 中 ,活动 中 有 的 回调 方法 , 碎片 中 几乎 
都 有 ， 不 过 碎片 还 提供 了 一 些 附加 的 回调 方法 ， 那 我 们 就 重点 看 一 下 这 几 个 回调 。 
口 onAttach () 。 当 碎片 和 活动 建立 关联 的 时 候 调 用 。 
口 onCreateView()。 为 碎片 创建 视图 ( 加载 布 局 ) 时 调用 
口 onActivityCreated()。 确保 与 碎片 相关 联 的 活动 一 定 已 经 创建 完毕 的 时 候 调 用 。 
口 onDestroyView()。 当 与 碎片 关联 的 视图 被 移 除 的 时 候 调用 。 
口 onDetach()。 当 碎片 和 活动 解除 关联 的 时 候 调 用 。 
碎片 完整 的 生命 周期 示意 图 可 参考 图 4.7， 图 片 源 自 Android 官网 。 
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图 4.7 


4.3.2 ”体验 碎片 的 生命 周期 


为 了 让 你 能 够 更 加 直观 地 体验 碎片 的 生命 周期 , 我 们 还 是 通过 一 个 例子 来 实践 一 下 。 例子 很 


碎片 的 生命 周期 


简单 ， 仍 然 是 在 FragmentTest 项 目的 基础 上 改动 的 。 
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修改 RightFragment 中 的 代码 ， 如 下 所 示 : 
public class RightFragment extends Fragment { 


public static final String TAG = "RightFragment"; 


@Override 

public void onAttach(Context context) { 
super.onAttach (context); 
Log.d(TAG, "onAttach"); 

} 


@Override 

public void onCreate(Bundle savedInstanceState) { 
super.onCreate(savedInstanceState); 
Log.d(TAG, "onCreate"); 

} 


@Override 
public View onCreateView(LayoutInfLater inflater, ViewGroup container, 
Bundle savedInstanceState) { 
Log.d(TAG, "onCreateView"); 
View view = inflater.inflate(R.layout.right fragment, container, false); 
return view; 


} 


@Override 

public void onActivityCreated(Bundle savedInstanceState) { 
super.onActivityCreated(savedInstanceState) ; 
Log.d(TAG, "onActivityCreated"); 

} 


@Override 

public void onStart() { 
super.onStart(); 
Log.d(TAG, "onStart"); 

} 


@Override 

public void onResume() { 
super.onResume(); 
Log.d(TAG, "onResume"); 

} 


@Override 

public void onPause() { 
super .onPause(); 
Log.d(TAG, "onPause"); 

} 


@Override 

public void onStop() { 
super.onStop(); 
Log.d(TAG, "onStop"); 
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} 


@Override 

public void onDestroyView() { 
super .onDestroyView(); 
Log.d(TAG, "onDestroyView"); 

} 


@Override 

public void onDestroy() { 
super.onDestroy(); 
Log.d(TAG, "onDestroy"); 

} 


@Override 

public void onDetach() { 
super .onDetach(); 
Log.d(TAG, "onDetach"); 


} 


我 们 在 RightFragment 中 的 每 一 个 回调 方法 里 都 加 入 了 打印 日 志 的 代码 , 然后 重新 


这 时 观察 logcat 中 的 打印 信息 ， 如 图 4.8 所 示 。 


A 


运行 程序 ， 


bose 国 QRionrraoment 
C , 


com. example. fragmenttest D/RightFragment 
com. example. fragmenttest D/RightFragment 
com. example. fragmenttest D/RightFragment: 
com. example. fragmenttest D/RightFragment 
com. example. fragmenttest D/RightFragment: onStart 
com. example. fragmenttest D/RightFragment: 


图 4.8 


onAttach 

onCreate 
onCreateView 
onActivityCreated 


onResume 


启动 程序 时 的 打印 日 志 


可 以 看 到 ， 当 RightFragment 第 一 次 被 加 载 到 


屏幕 上 时 ， 会 依次 执行 onAttach() 、 


onCreate()、 onCreateView(). a onStart() 和 onResume() 方 法 。 然 
后 点 击 LeftFragment 中 的 按钮 ， 此 时 打印 信息 如 图 4.9 所 示 。 
[ve TE - 加 (QRightFragment ) 


com. ne fragmenttest D /RightFragment:: onPause 


com. example. fragmenttest D/RightFragment: onStop 


com. example. fragmenttest D/RightFragment: onDestroyView 


图 4.9 


由 于 AnotherRightFragment 替换 了 RightFragment， 


因此 onPause()、onStop() 和 onDestroyView() 方 法 会 
调用 addToBackStack() 方 法 ， 此 时 的 RightFragment 就 会 


onDetach() 方 法 就 会 得 到 执行 。 


接着 按 下 Back 键 ，RightFragment 会 重新 回 到 屏幕 ， 


替换 成 AnotherRightFragment 时 的 打印 日 志 


此 时 的 RightFragment 进入 了 停止 状态 ， 
得 到 执行 。 当 然 如 果 在 替换 的 时 候 没 有 
进入 销毁 状态 ，onDestroy() 和 


打印 信息 如 图 4.10 所 示 。 
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图 4.10 返回 RightFragment 时 的 打印 日 志 


由 于 RightFragment 重新 回 到 了 运行 状态 , 因此 onCreateView()、 onActivityCreated()、 
onStart() 和 onResume() 方 法 会 得 到 执行 。 注 意 此 时 onCreate ( ) 方 法 并 不 会 执行 ， 因 为 我 们 
借助 了 addToBackStack () 方 法 使 得 RightFragment 并 没有 被 销毁 。 


现在 再 次 按 下 Back 键 ， 打 印信 息 如 图 4.11 所 示 。 


[Verbose | (QRightFragment 
nttest D/RightFragment: onPause 
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onDestroyView 


nttest D/RightFragment: onDetach 


图 4.11 退出 程序 时 的 打印 日 志 
依次 会 执行 onPause()、onStop()、onDestroyView()、onDestroy() 和 onDetach() 方 


法 , 最 终 将 碎片 销 磺 掉 。 这 样 碎片 完整 的 生命 周期 你 也 体验 了 一 遍 ， 是 不 是 理解 得 更 加 深刻 了 ? 

另外 值得 一 提 的 是 ,在 碎片 中 你 也 是 可 以 通过 onSaveInstanceState() 方 法 来 保存 数据 的 ， 
因为 进入 停止 状态 的 碎片 有 可 能 在 系统 内 存 不 足 的 时 候 被 回收 。 保 存 下 来 的 数据 在 onCreate()、 
onCreateView() 和 onActivityCreated() 这 3 个 方法 中 你 都 可 以 重新 得 到 ， 它 们 都 含有 一 个 
Bundle 类 型 的 savedInstanceState 参数 。 具 体 的 代码 我 就 不 在 这 里 给 出 了 ， 如 果 你 忘记 了 该 
如 何 编写 ， 可 以 参考 2.4.5 小 节 。 


动态 加 载 布局 的 技巧 


昌 然 动态 添加 碎片 的 功能 很 强大 , 可 以 解决 很 多 实际 开发 中 的 问题 , 但 是 它 毕 竟 只 是 在 
布局 文件 中 进行 一 些 添加 和 替换 操作 。 如果 程序 能 够 根据 设备 的 分 辨 率 或 屏幕 大 小 在 运行 时 来 决 
定 加 载 哪个 布局 ， 那 我 们 可 发 挥 的 空间 就 更 多 了 。 因 此 本 节 我 们 就 来 探讨 一 下 Android 中 动态 加 
载 布 局 的 技巧 。 


4.4.1 使 用 限定 符 


如 果 你 经 常 使 用 平板 电脑 ,应 该 会 发 现 现在 很 多 的 平板 应 用 都 采用 的 是 双 页 模式 ( 程序 会 在 
左 侧 的 面板 上 显示 一 个 包含 子 项 的 列表 ， 在 右 侧 的 面板 上 显示 内 容 )， 因 为 平板 电脑 的 屏幕 足够 
大 , 完全 可 以 同时 显示 下 两 页 的 内 容 , 但 手机 的 屏幕 一 次 就 只 能 显示 一 页 的 内 容 , 因此 两 个 页 面 
需要 分 开 显示 。 


4.4 


个 
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那么 怎样 才能 在 运行 时 判断 程序 应 该 是 使 用 双 页 模式 还 是 单 页 模式 呢 ? 这 就 需要 借助 限定 
| 个 例子 来 学 习 一 下 它 的 用 法 ， 修 改 FragmentTest 项 目 
中 的 activity main.xml 文件 ， 代 码 如 下 所 示 : 
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:orientation="horizontal" 


android:layout width="match parent" 
android:layout height="match parent" > 


<fragment 
android:id="@+id/left fragment" 
android:name="com.example.fragmenttest.LeftFragment" 
android:Tlayout width="match_parent" 
android:layout height="match parent"/> 


</LinearLayout> 


这 里 将 多 余 的 代码 都 删 掉 ， 只 留 下 一 个 左 侧 碎片 ， 并 让 它 充 满 整 个 父 布局 。 接 着 在 res 目录 
下 新 建 layout-large 文件 夹 ， 在 这 个 文件 夹 下 新 建 一 个 布局 ， 也 叫 作 activity_main.xml， 代 码 如 下 
所 示 : 


<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:orientation="horizontal" 
android:layout width="match parent" 
android:layout height="match parent"> 


<fragment 
android:id="@+id/left fragment" 
android:name="com.example.fragmenttest.LeftFragment" 
android:Layout width="0dp" 
android:layout height="match parent" 
android:layout weight="1" /> 


<fragment 
android:id="@+id/right fragment" 
android:name="com.example.fragmenttest.RightFragment" 
android:Layout width="0dp" 
android:layout height="match parent" 
android:layout weight="3" /> 


</LinearLayout> 


可 以 看 到 ，layout/activity_main 布局 只 包含 了 一 个 碎片 ， 即 单 页 模式 ， 而 layout-large/ 
activity main 布局 包含 了 两 个 碎片 ， 即 双 页 模式 。 其 中 Large 就 是 一 个 限定 符 ， 那 些 屏幕 被 认为 
是 Large 的 设备 就 会 自动 加 载 layout-large 文件 夹 下 的 布局 ,而 小 屏幕 的 设备 则 还 是 会 加 载 layout 
文件 夹 下 的 布局 。 


然后 将 MainActivity 中 replaceFragment() 方 法 里 的 代码 注释 掉 ， 并 在 平板 模拟 右上 重新 
运行 程序 ， 效 果 如 图 4.12 所 示 。 
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FragmentTest 


图 4.12” 双 页 模式 运行 效果 


再 启动 一 个 手机 模拟 器 ， 并 在 这 个 模拟 器 上 重新 运行 程序 ， 效 果 如 图 4.13 所 示 。 


FragmentTest 


] O 口 


图 4.13 单 页 模式 运行 效果 


这 样 我 们 就 实现 了 在 程序 运行 时 动态 加 载 布 局 的 功能 。 
Android 中 一 些 常 见 的 限定 符 可 以 参考 下 表 。 


屏幕 特征 限定 符 描述 
small 提供 给 小 屏幕 设备 的 资源 
A normal 提供 给 中 等 屏幕 设备 的 资源 
Large 提供 给 大 屏幕 设备 的 资源 


xlarge 提供 给 超大 屏幕 设备 的 资源 
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( 续 ) 
屏幕 特征 限定 符 描 述 
ldpi 提供 给 低 分 辨 率 设备 的 资源 (120dpi 以 下 ) 
mdpi 提供 给 中 等 分 辨 率 设备 的 资源 (120dpi~160dpi) 
分 辨 率 hdpi 提供 给 高 分 辨 率 设备 的 资源 (160dpi~240dpi) 
xhdpi 提供 给 超 高 分 辨 率 设备 的 资源 (240dpi~320dpi) 
xxhdpi 提供 给 超 超 高 分 辩 率 设备 的 资源 (320dpi~480dpi) 
， Land 提供 给 横 屏 设备 的 资源 
port 提供 给 竖 屏 设备 的 资源 


4.4.2 ”使 用 最 小 宽度 限定 符 


在 上 一 小 节 中 我 们 使 用 Large 限定 符 成 功 解决 了 单 页 双 页 的 判断 问题 ， 不 过 很 快 又 有 一 个 
新 的 问题 出 现 了 , Large 到 底 是 指 多 大 呢 ?” 有 的 时 候 我 们 希望 可 以 更 加 灵活 地 为 不 同 设备 加 载 布 
局 ,不 管 它们 是 不 是 被 系统 认定 为 large ， 这 时 就 可 以 使 用 最 小 宽度 限定 符 ( Smallest-width 
Qualifier ) 了 。 

最 小 宽度 限定 符 允 许 我 们 对 屏幕 的 宽度 指定 一 个 最 小 值 ( 以 dp 为 单位 ), 然后 以 这 个 最 小 值 
为 临界 点 , 屏幕 宽度 大 于 这 个 值 的 设备 就 加 载 一 个 布局 , 屏幕 宽度 小 于 这 个 值 的 设备 就 加 载 男 一 
个 布局 。 

在 res 目录 下 新 建 layout-sw600dp 文件 夹 ， 然 后 在 这 个 文件 夹 下 新 建 activity main.xml 布局 ， 
代码 如 下 所 示 : 


<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:orientation="horizontal" 
android:layout width="match parent" 
android:layout height="match parent"> 


<fragment 
android:id="@+id/left fragment" 
android:name="com.example.fragmenttest.LeftFragment" 
android:Layout width="0dp" 
android:layout height="match parent" 
android:layout weight="1” /> 


<fragment 
android:id="@+id/right fragment" 
android:name="com.example.fragmenttest.RightFragment" 
android:Layout width="0dp" 
android:layout height="match parent" 
android:layout weight="3" /> 


</LinearLayout> 


这 就 意味 着 , 当 程 序 运行 在 屏幕 宽度 大 于 600dp 的 设备 上 时 ,会 加 载 layout-sw600dp/activity_main 
布局 ， 当 程序 运行 在 屏幕 宽度 小 于 600dp 的 设备 上 时 , 则 仍然 加 载 默认 的 layout/activity_main 布局 。 
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4.5 碎片 的 最 佳 实践 一 一 一 个 简易 版 的 新 闻 应 用 


现在 你 已 经 将 关于 碎片 的 重要 知识 点 都 掌握 得 差不多 了 , 不 过 在 灵活 运用 方面 可 能 还 有 些 欠 
缺 ， 因 此 下 面 该 进入 我 们 本 章 的 最 佳 实践 环节 了 。 

前 面 有 提 到 过 , 碎片 很 多 时 候 都 是 在 平板 开发 当中 使 用 的 ， 主 要 是 为 了 解决 屏幕 空间 不 能 充 
分 利用 的 问题 。 那 是 不 是 就 表明 , 我 们 开发 的 程序 都 需要 提供 一 个 手机 版 和 一 个 Pad 版 呢 ? 确实 
有 不 少 公司 都 是 这 么 做 的 , 但 是 这 样 会 浪费 很 多 的 人 力 物力 .因为 维护 两 个 版 本 的 代码 成 本 很 高 ， 
每 当 增加 什么 新 功能 时 ， 需 要 在 两 份 代码 里 各 写 一 裔 ， 每 当 发 现 一 个 bug 时 ， 需 要 在 两 份 代码 里 
各 修改 一 次 。 因此 今天 我 们 最 佳 实践 的 内 容 就 是 , 教 你 如 何 编写 同时 兼容 手机 和 平板 的 应 用 程序 。 

还 记得 在 本 章 开始 的 时 候 提 到 过 的 一 个 新 闻 应 用 吗 ? 现在 我 们 就 将 运用 本 章 中 所 学 的 知识 
来 编写 一 个 简易 版 的 新 闻 应 用 ， 并 且 要 求 它 是 可 以 同时 兼容 手机 和 平板 的 。 新 建 好 一 个 
FragmentBestPractice 项 目 ， 然 后 开始 动手 吧 ! 

由 于 待 会 在 编写 新 闻 列表 时 会 使 用 到 RecyclerView, 因此 首先 需要 在 app/build.gradle 当中 汪 
加 依赖 库 ， 如 下 所 示 : 


dependencies { 
compile fileTree(dir: 'libs', include: ['*.jar']) 
compile 'com.android,.support:appcompat-v7:24.2.1" 
testCompile ‘junit:junit:4.12'" 
compile 'com.android.support:recyclerview-v7:24.2.1' 


接 下 来 我 们 要 准备 好 一 个 新 闻 的 实体 类 ， 新 建 类 News ， 代 码 如 下 所 示 : 
public class News { 

private String title; 

private String content; 


public String getTitle() { 
return title; 


} 


public void setTitle(String title) { 
this.title = title; 
} 


public String getContent() { 
return content; 


} 


public void setContent(String content) { 
this.content = content; 
} 
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News 类 的 代码 还 是 比较 简单 的 ，title 字段 表示 新 闻 标 题 ，content 字段 表示 新 闻 内 容 。 
接着 新 建 布局 文件 news_content_frag.xml， 用 于 作为 新 闻 内 容 的 布局 : 


<RelativeLayout xmlns:android="http://schemas.android.com/apk/res/android" 


android:layout width="match parent" 
android:layout height="match parent"> 


<LinearLayout 
android:id="@+id/visibility layout" 
android:layout width="match parent" 
android:layout height="match parent" 
android:orientation="vertical" 
android:visibility="invisible" > 


<TextView 
android:id="@+id/news title" 
android:layout width="match parent" 
android:layout height="wrap content" 
android:gravity="center" 
android:padding="10dp" 
android:textSize="20sp" /> 


<View 
android:layout width="match parent" 
android:layout height="1ldp" 
android:background="#000" /> 


<TextView 
android:id="@+id/news content" 
android:layout width="match parent" 
android:layout height="Qdp" 
android:layout weight="1" 
android:padding="15dp" 
android:textSize="1l8sp" /> 


</LinearLayout> 


<View 
android:Layout width="1dp" 
android:layout height="match parent" 
android:layout alignParentLeft="true" 
android:background="#000" /> 


</RelativeLayout> 


新 闻 内 容 的 布局 主要 可 以 分 为 两 个 部 分 ， 头 部 部 分 显示 新 闻 标 题 ， 正 文部 分 显示 新 闻 内 容 ， 
中 间 使 用 一 条 细 线 分 隔 开 。 这 里 的 细 线 是 利用 View 来 实现 的 ,将 View 的 宽 或 高 设置 为 1tp， 再 


通过 background 属性 给 细 线 设置 一 下 颜色 就 可 以 了 。 这 里 我 们 把 细 线 设置 成 


Dw 


色 。 


然后 再 新 建 一 个 NewsContentFragment 类 ， 继承 自 Fragment， 代 码 如 下 所 示 : 


public class NewsContentFragment extends Fragment { 
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private View view; 


@Override 
public View onCreateView(LayoutInflater inflater, ViewGroup container, 
Bundle savedInstanceState) { 
view = inflater.inflate(R.layout.news content frag, container, false); 
return view; 


} 


public void refresh(String newsTitle, String newsContent) { 
View visibilityLayout = view.findViewById(R.id.visibility layout); 
visibilityLayout.setVisibility(View.VISIBLE); 
TextView newsTitleText = (TextView) view.findViewById (R.id.news title); 
TextView newsContentText = (TextView) view.findViewById(R.id.news content); 
newsTitleText.setText(newsTitle); // 刷新 新 闻 的 标题 
newsContentText.setText(newsContent); // 刷新 新 闻 的 内 容 


} 


首先 在 onCreateView() 方 法 里 加 载 了 我 们 刚刚 创建 的 news_content_frag 布 局 , 这 个 没什么 
好 解释 的 。 接 下 来 又 提供 了 一 个 refresh() 方 法 , 这 个 方法 就 是 用 于 将 新 闻 的 标题 和 内 容 显示 在 
界面 上 的 。 可 以 看 到 ， 这 里 通过 findViewById () 方 法 分 别 获 取 到 新 闻 标 题 和 内 容 的 控件 ， 然 后 
将 方法 传递 进来 的 参数 设置 进去 。 

这 样 我 们 就 把 新 闻 内 容 的 碎片 和 布局 都 创建 好 了 , 但 是 它们 都 是 在 双 页 模式 中 使 用 的 , 如 果 
想 在 单 页 模式 中 使 用 的 话 ， 我 们 还 需要 再 创建 一 个 活动 。 右 击 com.example.fragmentbestpractice 
包 一 New 一 Activity 一 Empty Activity ， 新 建 一 个 NewsContentActivity ， 并 将 布局 名 指定 成 
news_content， 然 后 修改 news_content.xml 中 的 代码 ， 如 下 所 示 : 


<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:orientation="vertical" 
android:layout width="match parent" 
android:layout height="match parent"> 


<fragment 
android:id="@+id/news content fragment" 
android:name="com.example.fragmentbestpractice.NewsContentFragment" 
android:layout width="match parent" 
android:layout height="match parent" 
/> 


</LinearLayout> 


这 里 我 们 充分 发 挥 了 代码 的 复 用 性 ， 直 接 在 布局 中 引入 了 NewsContentFragment ， 这 样 也 
就 相当 于 把 news_content frag 布局 的 内 容 自动 加 了 进来 。 
然后 修改 NewsContentActivity 中 的 代码 ， 如 下 所 示 : 


public class NewsContentActivity extends AppCompatActivity { 
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public static void actionStart(Context context, String newsTitle, String 
newsContent) { 
Intent intent = new Intent(context, NewsContentActivity.class); 
intent.putExtra("news title", newsTitle); 
intent.putExtra("news content", newsContent); 
context.startActivity(intent); 

} 


@Override 

protected void onCreate(Bundle savedInstanceState) { 
super.onCreate(savedInstanceState); 
setContentView(R.layout.news content); 
String newsTitle = getIntent().getStringExtra("news title"); // 获取 传 入 的 新 
闻 标 题 
String newsContent = getIntent().getStringExtra("news content"); // 获取 传 入 
的 新 闻 内 容 
NewsContentFragment newsContentFragment = (NewsContentFragment) 
getSupportFragmentManager().findFragmentById(R.id.news content fragment); 
newsContentFragment.refresh(newsTitle, newsContent); // 刷 新 NewsContent- 

Fragment 界面 


} 


可 以 看 到 ,在 onCreate() 方 法 中 我 们 通过 Intent 获取 到 了 传人 的 新 闻 标题 和 新 闻 内 容 ， 然 
后 调用 FragmentManager 的 findFragmentById() 方 法 得 到 了 NewsContentFragment 的 实例 ， 
接着 调用 它 的 refresh() 方 法 , 并 将 新 闻 的 标题 和 内 容 传人 ,就 可 以 把 这 些 数据 显示 出 来 了 。 注 
意 这 里 我 们 还 提供 了 一 个 actionSstart() 方 法 ， 还 记得 它 的 作用 吗 ? 如 果 忘 记 的 话 就 再 去 阅读 
一 遍 2.6.3 小 节 吧 。 


接 下 来 还 需要 再 创建 一 个 用 于 显示 新 闻 列 表 的 布局 ， 新 建 news_title_frag.xml， 代 码 如 下 
所 示 : 


<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:orientation="vertical" 
android:layout width="match parent" 
android:layout height="match parent"> 


<android.support.v7.widget.RecyclerView 
android:id="@+id/news title recycler view" 
android:layout width="match parent" 
android:layout height="match parent" 
/> 


</LinearLayout> 
这 个 布局 的 代码 就 非常 简单 了 , 里面 只 有 一 个 用 于 显示 新 闻 列 表 的 RecyclerView。 既 然 要 用 


到 RecyclerView， 那 么 就 必定 少不了 子 项 的 布局 。 新 建 news_item.xml 作为 RecyclerView 子 项 的 
布局 ， 代 码 如 下 所 示 : 


<TextView xmlns:android="http://schemas.android.com/apk/res/android" 
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android:id="@+id/news title" 
android:layout width="match parent" 
android:layout height="wrap_content" 
android:maxLines="true" 
android:ellipsize="end" 
android:textSize="18sp" 
android:paddingLeft="10dp" 
android:paddingRight="10dp" 
android:paddingTop="15dp" 
android:paddingBottom="15dp” /> 


子 项 的 布局 也 非常 简单 ， 只 有 一 个 TextView。 仔 细 观 察 TextView， 你 会 发 现 其 中 有 有 几 个 属 
性 是 我 们 之 前 没有 学 过 的 。android:padding 表示 给 控件 的 周围 加 上 补 白 ， 这 样 不 至 于 让 文本 
内 容 会 紧 靠 在 边缘 上 。android:maxLines 设置 为 true 表示 让 这 个 TextView 只 能 单行 显示 。 
android:ellipsize 用 于 设 定 当 文本 内 容 超出 控件 宽度 时 ， 文 本 的 缩 略 方式 ， 这 里 指定 成 end 
表示 在 尾部 进行 缩 略 。 

既然 新 闻 列 表 和 子 项 的 布局 都 已 经 创建 好 了 , 那么 接 下 来 我 们 就 需要 一 个 用 于 展示 新 闻 列 表 
的 地 方 。 这 里 新 建 NewsTitleFragment 作为 展示 新 闻 列 表 的 碎片 ， 代 码 如 下 所 示 : 


public class NewsTitLeFragment extends Fragment { 


private boolean isTwoPane; 


@Override 
public View onCreateView(LayoutInflater inflater, ViewGroup container, 
Bundle savedInstanceState) { 
View view = inflater.inflate(R.layout.news title frag, container, false); 
return view; 


} 


@Override 
public void onActivityCreated(Bundle savedInstanceState) { 
super.onActivityCreated(savedInstanceState); 
if (getActivity().findViewById(R.id.news content layout) != null) { 
isTwoPane = true; // 可 以 找到 news_content Layout 布局 时 ， 为 双 页 模式 
} else { 
isTwoPane = false; // 找 不 到 news content Layout 布局 时 ， 为 单 页 模式 
} 


} 


可 以 看 到 ，NewsTitleFragment 中 并 没有 多 少 代 码 ， 在 onCreateView() 方 法 中 加 载 了 
news_title_frag 布局 ， 这 个 没什么 好 说 的 。 我 们 注意 看 一 下 onActivityCreated() 方 法 , 这 个 方 
法 通过 在 活动 中 能 否 找 到 一 个 id 为 news_content layout 的 View 来 判断 当前 是 双 页 模式 还 是 单 
页 模式 ， 因 此 我 们 需要 让 这 个 id 为 news_content layout 的 View 只 在 双 页 模式 中 才 会 出 现 。 

那么 怎样 才能 实现 这 个 功能 呢 ?” 其 实 并 不 复杂 ， 只 需要 借助 我 们 刚刚 学 过 的 限定 符 就 可 以 
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了 。 首 先 修改 activity_main.xml 中 的 代码 ， 如 下 所 示 : 


<FrameLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:id="@+id/news title layout" 
android:layout width="match parent" 
android:layout height="match parent" > 


<fragment 
android:id="@+id/news title fragment" 
android:name="com.example.fragmentbestpractice.NewsTitleFragment" 
android:layout width="match parent" 
android:layout height="match parent" 
/> 


</FrameLayout> 

上 述 代码 表示 ， 在 单 页 模式 下 ， 只 会 加 载 一 个 新 闻 标 题 的 碎片 。 

然后 新 建 layout-sw600dp 文件 夹 ， 在 这 个 文件 夹 下 再 新 建 一 个 activity_main.xml 文件 ， 代 码 
如 下 所 示 : 


<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:orientation="horizontal" 
android:layout width="match parent" 
android:layout height="match parent" > 


<fragment 
android:id="@+id/news title fragment" 
android:name="com.example.fragmentbestpractice,.NewsTitleFragment" 
android:Layout width="0dp" 
android:layout height="match parent" 
android:layout weight="1" /> 


<FrameLayout 
android:id="@+id/news content layout" 
android:layout width="Qdp" 
android:layout height="match parent" 
android:layout weight="3" > 


<fragment 
android:id="@+id/news content fragment" 
android:name="com.example.fragmentbestpractice.NewsContentFragment" 
android:layout width="match parent" 
android:layout height="match parent" /> 
</FrameLayout> 


</LinearLayout> 

可 以 看 出 , 在 双 页 模式 下 我 们 同时 引入 了 两 个 碎片 , 并 将 新 闻 内 容 的 碎片 放 在 了 一 个 Frame- 
Layout 布局 下 ， 而 这 个 布局 的 id 正 是 news_content layout。 因 此 ， 能 够 找到 这 个 id 的 时 候 就 是 
双 页 模式 ， 否 则 就 是 单 面 模式 。 

现在 我 们 已 经 将 绝 大 部 分 的 工作 都 完成 了 ， 但 还 剩 下 至 关 重 要 的 一 点 ， 就 是 在 NewsTitle- 
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Fragment 中 通过 RecyclerView 将 新 闻 列 表 展 示 出 来 。 我 们 在 NewsTitleFragment 中 新 建 
内 部 类 NewsAdapter 来 作为 RecyclerView 的 适配器 ， 如 下 所 示 


public class NewsTitleFragment extends Fragment { 


private boolean isTwoPane; 


class NewsAdapter extends RecyclerView.Adapter<NewsAdapter.ViewHolder> { 
private List<News> mNewsList; 
class ViewHolder extends RecyclerView.ViewHolder { 
TextView newsTitleText; 


public ViewHolder(View view) { 
super (view); 
newsTitleText = (TextView) view.findViewById(R.id.news title); 


} 


public NewsAdapter(List<News> newsList) { 
mNewsList = newsList; 


} 


@Override 
public ViewHolder onCreateViewHolder(ViewGroup parent, int viewType) { 
View view = LayoutInflater.from(parent.getContext()) 
.inflate(R.Tlayout.news_ item, parent, false); 
final ViewHolder holder = new ViewHolder (view); 
view.setOnClickListener(new View.0nCLickListener() { 
@Override 
public void onClick(View v) { 
News news = mNewsList.get(holder.getAdapterPosition()); 
if (isTwoPane) { 
// 如 果 是 双 页 模式 ， 则 刷新 NewsContentFragment 中 的 内 容 
NewsContentFragment newsContentFragment = 
(NewsContentFragment) getFragmentManager() 
.findFragmentById(R.id.news_ content fragment); 
newsContentFragment.refresh(news.getTitle(), 
news .getContent () ) ; 
} else { 
// 如 果 是 单 页 模式 ， 则 直接 启动 NewsContentActivity 
NewsContentActivity.actionStart(getActivity(), 
news.getTitle(), news.getContent()); 


} 
}); 
return holder; 
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} 


@Override 

public void onBindViewHolder(ViewHolder holder, int position) { 
News news = mNewsList.get(position); 
holder.newsTitleText.setText(news.getTitle()); 

} 


@Override 
public int getItemCount() { 
return mNewsList.size(); 


} 


RecyclerView 的 用 法 你 已 经 相当 熟练 了 ， 因 此 这 个 适配器 的 代码 对 你 来 说 应 该 没有 什么 难 
度 吧 ? 需要 注意 的 是 ， 之 前 我 们 都 是 将 适配器 写成 一 个 独立 的 类 ， 其 实 也 是 可 以 写成 内 部 类 的 ， 
这 里 写成 内 部 类 的 好 处 就 是 可 以 直接 访问 NewsTitleFragment 的 变量 ， 比 如 isTwoPane。 

观察 一 下 onCreateViewHolder() 方 法 中 注册 的 点 击 事件 ,首先 获取 到 了 点 击 项 的 News 实 


例 ， 然 后 通 


过 isTwoPane 变量 来 判断 当前 是 单 页 还 是 双 页 模式 ， 如 果 是 单 页 模式 ， 就 启动 一 个 


新 的 活动 去 显示 新 闻 内 容 ， 如 果 是 双 页 模式 ， 就 更 新 新 闻 内 容 碎片 里 的 数据 。 


现在 还 剩 最 后 一 步 收 尾 工 作 ， 就 是 向 RecyclerView 中 填充 数据 了 。 修 改 NewsTitle- 
Fragment 中 的 代码 ， 如 下 所 示 : 


public class NewsTitleFragment extends Fragment { 


GOverride 
public View onCreateView(LayoutInfLater inflater, ViewGroup container， 


} 


Bundle savedInstanceState) { 
View view = inflater.inflate(R.layout.news title frag, container, false); 
RecyclerView newsTitleRecyclerView = (RecyclerView) view.findViewById 

(R.id.news title recycler view); 

LinearLayoutManager layoutManager = new LinearLayoutManager (getActivity()); 
newsTitleRecyclerView.setLayoutManager (layoutManager); 
NewsAdapter adapter = new NewsAdapter (getNews()); 
newsTitleRecyclerView.setAdapter (adapter); 
return view; 


private List<News> getNews() { 


List<News> newsList = new ArrayList<>(); 
for (int i = 1; i <= 50; i++) { 
News news = new News(); 
news.setTitle("This is news title " + i); 
news .setContent (getRandomLengthContent("This is news content "+i+". ")); 
newsList .add (news); 
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return newsList; 


} 


private String getRandomLengthContent(String content) { 
Random random = new Random(); 
int length = random.nextInt(20) + 1; 
StringBuilder builder = new StringBuilder(); 
for (int i = 0; i < length; i++) { 
builder.append(content); 
} 


return builder.toString(); 


} 
可 以 看 到 ，onCreateView() 方 法 中 添加 了 RecyclerView 标准 的 使 用 方法 ， 在 碎片 中 使 用 
RecyclerView 和 在 活动 中 使 用 几乎 是 一 模 一 样 的 ， 相 信 没 有 什么 需要 解释 的 。 另 外 ， 这 里 调用 
了 getNews () 方 法 来 初始 化 50 条 模拟 新 闻 数 据 , 同样 使 用 了 一 个 getRandomLengthContent() 
方法 来 随机 生成 新 闻 内 容 的 长 度 , 以 保证 每 条 新 闻 的 内 容 差 距 比 较 大 , 相信 你 对 这 个 方法 肯定 不 
会 陌生 了 。 


\ 一 人 一 


这 样 我 们 所 有 的 编写 工作 就 已 经 完成 了 , 赶快 来 运行 一 下 吧 ! 首先 在 手机 模拟 器 上 运行 , 效 
果 如 图 4.14 所 示 。 

可 以 看 到 许多 条 新 闻 的 标题 ,然后 点 击 第 一 条 新 闻 , 会 启动 一 个 新 的 活动 来 显示 新 闻 的 内 容 ， 
效果 如 图 4.15 所 示 。 


i 8:53 
FragmentBestPractice FragmentBestPractice 


This is news title 1 


This is news title 1 


图 4.14 单 页 模式 的 新 闻 列表 界面 图 4.15 单 页 模式 的 新 闻 内 容 界 面 
接 下 来 将 程序 在 平板 模拟 器 上 运行 ， 同 样 点 击 第 一 条 新 闻 ， 效 果 如 图 4.16 所 示 。 
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i 6:57 
FragmentBestPractice 


图 4.16 ” 双 页 模式 的 新 闻 标 题 和 内 容 界面 


怎么 样 ? 同样 的 一 份 代码 , 在 手机 和 平板 上 运行 却 分 别 是 两 种 完全 不 同 的 效果 , 说 明 我 们 程 
序 的 兼容 性 已 经 相当 不 错 了 。 通过 这 个 例子 , 我 相信 你 对 碎片 的 理解 一 定 又 加 深 了 很 多 , 现在 就 
让 我 们 一 起 来 总 结 一 下 吧 。 
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你 应 该 可 以 感觉 到 ， 上 一 节 中 我 们 开发 的 新 闻 应 用 ,代码 复杂 度 还 是 有 点 高 的 ， 比 起 只 需要 
兼容 一 个 终端 的 应 用 , 我 们 要 考虑 的 东西 多 了 很 多 。 不 过 在 开发 的 过 程 中 多 付出 一 些 , 在 以 后 的 
代码 维护 中 就 可 以 轻松 很 多 。 因 此 ， 有 时 候 提前 的 付出 还 是 很 值得 的 。 

我 们 再 来 回顾 一 下 本 章 所 学 的 内 容 吧 , 首先 你 了 解 了 碎片 的 基本 概念 以 及 使 用 场景 , 接着 通 
过 几 个 实例 掌握 了 碎片 的 常见 用 法 , 随后 又 学 习 了 碎片 生命 周期 的 相关 内 容 以 及 动态 加 载 布 局 的 
技巧 , 最 后 在 本 章 的 最 佳 实践 部 分 将 前 面 所 学 的 内 容 综合 运用 了 一 遍 , 相信 你 已 经 将 碎片 相关 知 
识 点 都 牢记 在 心 ， 并 可 以 较为 熟练 地 应 用 了 。 

本 章 其 实 是 具有 一 个 里 程 碑 式 的 纪念 意义 的 ， 因 为 到 这 里 为 止 , 我 们 已 经 基本 将 Android UI 
相关 的 重要 知识 点 都 讲 完了 。 后 面 在 很 长 一 段 时 间 内 都 不 会 再 系统 性 地 介绍 UI 方面 的 知识 ， 而 
是 将 结合 前 面 所 学 的 UI 知识 来 更 好 地 讲解 相应 章节 的 内 容 。 那 么 我 们 下 一 章 将 要 学 习 什 么 呢 ? 
还 记得 在 第 1 章 里 介绍 过 的 Android 四 大 组 件 吧 ? 目前 我 们 只 掌握 了 活动 这 一 个 组 件 ， 那 么 下 一 
章 就 来 学 习 广播 接收 器 吧 。 跟 上 脚步 ， 准 备 继续 前 进 ! 
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全 局 大 喇叭 一 一 详解 广播 机 制 


记得 在 我 上 学 的 时 候 , 每 个 班级 的 教室 里 都 会 装 有 一 个 喇叭 , 这 些 喇 叭 都 是 接 人 到 学 校 的 广 
播 室 的 , 一旦 有 什么 重要 的 通知 ， 就 会 播放 一 条 广播 来 告知 全 校 的 师 生 。 类 似 的 工作 机 制 其 实在 
计算 机 领域 也 有 很 广泛 的 应 用 ， 如 果 你 了 解 网 络 通信 原理 应 该 会 知道 ， 在 一 个 卫 网 络 范围 中 ， 
最 大 的 卫 地 址 是 被 保留 作为 广播 地 址 来 使 用 的 。 比 如 某 个 网 络 的 卫 范围 是 192.168.0.XXX， 子 
网 掩 码 是 255.255.255.0, 那么 这 个 网 络 的 广播 地 址 就 是 192.168.0.255。 广播 数据 包 会 被 发 送 到 同 
一 网 络 上 的 所 有 端口 ， 这 样 在 该 网 络 中 的 每 台 主 机 都 将 会 收 到 这 条 广播 。 

为 了 便于 进行 系统 级 别 的 消息 通知 ，Android 也 引入 了 一 套 类 似 的 广播 消息 机 制 。 相 比 于 我 
前 面 举 出 的 两 个 例子 ，Android 中 的 广播 机 制 会 显得 更 加 灵活 ， 本 章 就 将 对 这 一 机 制 的 方方面面 
进行 详细 的 讲解 。 


5.1 广播 机 制 简介 


为 什么 说 Android 中 的 广播 机 制 更 加 灵活 呢 ? 这 是 因为 Android 中 的 每 个 应 用 程序 都 可 以 对 

自己 感 兴 趣 的 广播 进行 注册 , 这 样 该 程序 就 只 会 接收 到 自己 所 关心 的 广播 内 容 , 这 些 广播 可 能 是 

来 自 于 系统 的 ， 也 可 能 是 来 自 于 其 他 应 用 程序 的 。Android 提供 了 一 套 完 整 的 API， 人 允许 应 用 程 

序 自 由 地 发 送 和 接收 广播 。 发 送 广播 的 方法 其 实 之 前 稍微 提 到 过 ,如果 你 记性 好 的 话 可 能 还 会 有 

印象 ， 就 是 借助 我 们 第 2 章 学 过 的 Intent。 而 接收 广播 的 方法 则 需要 引入 一 个 新 的 概念 一 一 广播 

接收 需 (Broadcast Receiver )。 

广播 接收 器 的 具体 用 法 将 会 在 下 一 节 中 做 介绍 , 这 里 我 们 先 来 了 解 一 下 广播 的 类 型 。Android 

中 的 广播 主要 可 以 分 为 两 种 类 型 : 标准 广播 和 有 序 广播 。 

口 标准 广播 (Normalbroadcasts ) 是 一 种 完全 异步 执行 的 广播 ,在 广播 发 出 之 后 ， 所 有 的 广 
播 接收 器 几乎 都 会 在 同一 时 刻 接收 到 这 条 广播 消息 ， 因 此 它们 之 间 没 有 任何 先后 顺序 可 
言 。 这 种 广播 的 效率 会 比较 高 ， 但 同时 也 意味 着 它 是 无 法 被 截断 的 。 标 准 广播 的 工作 流 
程 如 图 5.1 所 示 。 
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口 有 序 广播 ( Ordered broadcasts 
会 有 一 个 广播 接收 需 能 够 收 至 


广播 接收 器 1 


发 出 一 条 广播 


广播 接收 器 2 


上 


广播 接收 器 3 


图 5.1 标准 广播 工作 示意 图 


) 则 是 一 种 同步 执行 的 广播 , 在 广播 发 出 之 后 ， 同 一 时 刻 只 
| 这 条 广播 消息 ， 当 这 个 广播 接收 器 中 的 逻辑 执行 完毕 后 ， 


广播 才 会 继续 传递 。 所 以 此 时 的 广播 接收 器 是 有 先后 顺序 的 ， 优 先 级 高 的 广播 接收 顺 就 
可 以 先 收 到 广播 消息 ， 并 且 前 面 的 广播 接收 需 还 可 以 截断 正在 传递 的 广播 ， 这 样 后 面 的 


广播 接收 需 就 无 法 收 到 广播 消息 了 。 有 


序 广播 的 工作 流程 如 图 5.2 所 示 。 


| 八 出 一 条 广播 一 :| 广播 撞 收 吕 1 


一 > [广播 措 履 宕 2 一 > [广播 措 履 只 3 


Android 内 置 了 很 多 系统 级 别 的 广 


时 间或 时 区 发 生 改 变 也 会 发 出 一 条 广播 


可 将 广播 截断 


可 将 广播 截断 


图 5.2 有 序 广播 工作 示意 图 
掌握 了 这 些 基本 概念 后 ,我们 就 可 以 来 尝试 一 下 广播 的 用 法 了 ,首先 就 从 接收 系统 广播 开始 吧 。 
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器 ， 下 面 我 们 就 来 看 一 下 它 的 具体 用 法 。 


5.2.1 动态 注册 监 
广播 接收 器 可 以 自 


听 网 络 变化 


收 需 就 能 够 收 到 该 广播 , 并 在 内 部 处 到 


播 ， 我 们 可 以 在 应 用 程序 中 通过 监听 这 些 广播 来 得 到 各 种 
系统 的 状态 信息 。 比 如 手机 开机 完成 后 会 发 出 一 条 广播 ， 电 池 的 电量 发 生变 化 会 发 出 一 条 广播 ， 
， 等 等 。 如 果 想 要 接收 到 这 些 广播 ,就 需要 使 用 广播 接收 


地 对 自己 感 兴趣 的 广播 进行 注册 , 这 样 当 有 相应 的 广播 发 出 时 , 广播 接 
相应 的 逻辑 。 注 册 广播 的 方式 一 般 有 两 种 , 在 代码 中 注册 


和 在 AndroidManifest.xml 中 注册 ， 其 中 前 者 也 被 称 为 动态 注册 ， 后 者 也 被 称 为 静态 注册 。 
个 广播 接收 需 呢 ? 其 实 只 需要 新 建 一 个 类 ， 让 它 继承 自 Broadcast- 


那么 该 如 何 创建 


Receiver， 并 重 写 父 类 


的 onReceive() 方 法 就 行 了 。 这 样 当 有 广播 到 来 时 ，onReceive() 方 法 
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就 会 得 到 执行 ， 具 体 的 逻辑 就 可 以 在 这 个 方法 中 处 理 。 


那 我 们 就 先 通过 动态 注册 的 方式 编写 一 个 能 够 监听 网 络 变化 的 程序 , 借 此 学 习 一 下 广播 接收 
需 的 基本 用 法 吧 。 新 建 一 个 BroadcastTest 项目， 然后 修改 MainActivity 中 的 代码 ， 如 下 所 示 : 


public class MainActivity extends AppCompatActivity { 
private IntentFilter intentFilter; 


private NetworkChangeReceiver networkChangeReceiver; 


@Override 

protected void onCreate(Bundle savedInstanceState) { 
super.onCreate(savedInstanceState); 
setContentView(R.layout.activity main); 
intentFilter = new IntentFilter(); 
intentFilter.addAction("android.net.conn.CONNECTIVITY CHANGE"); 
networkChangeReceiver = new NetworkChangeReceiver(); 
registerReceiver(networkChangeReceiver, intentFilter); 


} 


@Override 

protected void onDestroy() { 
super.onDestroy(); 
unregisterReceiver (networkChangeReceiver); 


} 


class NetworkChangeReceiver extends BroadcastReceiver { 


@Override 
public void onReceive(Context context, Intent intent) { 


Toast.makeText(context, "network changes", Toast.LENGTH_ SHORT).show(); 


} 


} 


可 以 看 到 ， 我 们 在 MainActivity 中 定义 了 一 个 内 部 类 NetworkChangeReceiver， 这 个 类 是 
继承 自 BroadcastReceiver 的 , 并 重 写 了 父 类 的 onReceive() 方 法 。 这样 每 当 网 络 状 态 发 生变 
化 时 ，onReceive() 方 法 就 会 得 到 执行 ， 这 里 只 是 简单 地 使 用 Toast 提示 了 一 段 文本 信息 。 

然后 观察 onCreate( ) 方 法 ， 首 先 我 们 创建 了 一 个 IntentFilter 的 实例 ， 并 给 它 添加 了 一 


个 值 为 android.net.conn.CONNECTIVITY CHANGE 的 action， 为 什么 要 添加 这 个 值 呢 ? 


网 络 状态 发 生变 化 时 , 系统 发 出 的 正 是 一 条 值 为 android.net.conn.CONNECTIVITY_CHANGE 的 


广播 ， 也 就 是 说 我 们 的 广播 接收 器 想 要 监听 什么 广播 ， 就 在 这 里 添加 相应 的 action。 接 下 来 创建 
EF 有 册 ， 将 


了 一 个 NetworkChangeReceiver 的 实例 ， 然 后 调用 registerReceiver () 方 法 进行 尘 


NetworkChangeReceiver 的 实例 和 IntentFitLter 的 实例 都 传 了 进去 ， 这 样 NetworkChange- 
Receiver 就 会 收 到 所 有 值 为 android.net.conn.CONNECTIVITY_CHANGE 的 广播 ， 也 就 实现 了 
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监听 网 络 变化 的 功能 。 

最 后 要 记得 ， 动 态 注册 的 广播 接收 器 一 定 都 要 取消 注册 才 行 ， 这 里 我 们 是 在 onDestroy() 
方法 中 通过 调用 unregisterReceiver() 方 法 来 实现 的 。 

整体 来 说 , 代码 还 是 非常 简单 的 ,现在 运行 一 下 程序 。 首 先 你 会 在 注册 完成 的 时 候 收 到 一 条 
广播 , 然后 按 下 Home 键 回 到 主 界面 ( 注意 不 能 按 Back 键 , 否则 onDestroy() 方 法 会 执行 ), 接 
着 打开 Settings 程序 一 Data usage 进入 到 数据 使 用 详情 界面 ,然后 尝试 着 开关 Cellular data 按钮 来 
启动 和 禁用 网 络 ， 你 就 会 看 到 有 Toast 提醒 你 网 络 发 生 了 变化 。 

不 过 , 只 是 提醒 网 络 发 生 了 变化 还 不 够 人 性 化 , 最 好 是 能 准确 地 告诉 用 户 当 前 是 有 网 络 还 是 
没有 网 络 ， 因 此 我 们 还 需要 对 上 面 的 代码 进行 进一步 的 优化 。 修 改 MainActivity 中 的 代码 ， 如 下 
所 示 : 


public class MainActivity extends AppCompatActivity { 


class NetworkChangeReceiver extends BroadcastReceiver { 


@Override 
public void onReceive(Context context, Intent intent) { 
ConnectivityManager connectionManager = (ConnectivityManager) 
getSystemService(Context.CONNECTIVITY SERVICE); 
NetworkInfo networkInfo = connectionManager.getActiveNetworkInfo() ; 
if (networkInfo != nuLL && networkInfo.isAvailable()) { 
Toast .makeText (context， "network is available", 
Toast,.LENGTH_SHORT) .show() ; 
} else{ 
Toast .makeText (context, "network is unavailable", 
Toast .LENGTH_ SHORT) .show() ; 


} 


在 onReceive() 方 法 中 ,首先 通过 getSystemService() 方 法 得 到 了 ConnectivityManager 
的 实例 ， 这 是 一 个 系统 服务 类 ， 专 门 用 于 管理 网 络 连接 的 。 然 后 调用 它 的 getActiveNetwork- 
Info() 方 法 可 以 得 到 NetworkInfo 的 实例 ， 接 着 调用 NetworkInfo 的 ijsAvailable() 方 法 ， 
就 可 以 判断 出 当前 是 否 有 网 络 了 ， 最 后 我 们 还 是 通过 Toast 的 方式 对 用 户 进行 提示 。 

另外 ， 这 里 有 非常 重要 的 一 点 需要 说 明 ，Android 系统 为 了 保护 用 户 设备 的 安全 和 隐私 ， 做 
了 严格 的 规定 : 如 果 程 序 需 要 进行 一 些 对 用 户 来 说 比较 敏感 的 操作 , 就 必须 在 配置 文件 中 声明 权 
限 才 可 以 ， 否则 程序 将 会 直接 山 演 。 比 如 这 里 访问 系统 的 网 络 状 态 就 是 需要 声明 权限 的 。 打 开 
AndroidManifest.xml 文件 ， 在 里 面 加 入 如 下 权限 就 可 以 访问 系统 网 络 状 态 了 : 


<manifest xmlns:android="http://schemas.android.com/apk/res/android" 
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package="com.example.broadcasttest"> 
<uses-permission android:name="android.permission.ACCESS_ NETWORK_STATE" /> 
</manifest> 
这 是 你 第 一 次 遇 到 权限 的 问题 ,其 实 Android 中 有 许多 操作 都 是 需要 声明 权限 才 可 以 进行 的 ， 
后 面 我 们 还 会 不 断 使 用 新 的 权限 。 不 过 目前 这 个 访问 系统 网 络 状 态 的 权限 还 是 比较 简单 的 , 只 需 
要 在 AndroidManifest.xml 文件 中 声明 一 下 就 可 以 了 ， 而 Android 6.0 系统 中 引入 了 更 加 严格 的 运 
行 时 权限 , 从 而 能 够 更 好 地 保证 用 户 设备 的 安全 和 隐私 , 关于 这 部 分 内 容 我 们 将 在 第 7 章 中 学 习 。 
现在 重新 运行 程序 ， 然 后 按 下 Home 键 一 Settings 一 Data usage， 进 入 到 数据 使 用 详情 界面 ， 
关闭 Cellular data 会 弹出 无 网 络 可 用 的 提示 ， 如 图 5.3 所 示 。 
然后 重新 打开 Cellular data 又 会 弹出 网 络 可 用 的 提示 ， 如 图 5.4 所 示 。 


三 Datausage 三 Data usage 


本 O 〇 口 
图 5.3 ”禁用 系统 网 络 图 5.4 启用 系统 网 络 


5.2.2 ”静态 注册 实现 开机 启动 


动态 注册 的 广播 接收 器 可 以 自由 地 控制 注册 与 注销 , 在 灵活 性 方面 有 很 大 的 优势 , 但 是 它 也 
存在 着 一 个 缺点 , 即 必 须要 在 程序 启动 之 后 才能 接收 到 广播 ,因为 注册 的 逻辑 是 写 在 onCreate() 
方法 中 的 。 那 么 有 没有 什么 办 法 可 以 让 程序 在 未 启动 的 情况 下 就 能 接收 到 广播 呢 ? 这 就 需要 使 用 
静态 注册 的 方式 了 。 

这 里 我 们 准备 让 程序 接收 一 条 开机 广播 ， 当 收 到 这 条 广播 时 就 可 以 在 onReceive() 方 法 里 
执行 相应 的 逻辑 ， 从 而 实现 开机 启动 的 功能 。 可 以 使 用 Android Studio 提供 的 快捷 方式 来 创建 一 
个 广播 接收 器 ， 右 击 com.example.broadcasttest 包 一 New 一 Other 一 Broadcast Receiver， 会 弹出 如 
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图 5.5 所 示 的 窗口 。 


区 王 | 


责 New Android Component 


EE ) Configure Component 


yx Android Studio 


Creates a new broadcast receiver component and adds it to your Android manifest 


Class Name: 。 | BootCompleteReceiver 


Exported 


Enabled 


[Previous ] [_ Nex | Eee Ezy | 
图 5.5 创建 广播 接收 器 的 窗口 
可 以 看 到 ， 这 里 我 们 将 广播 接收 器 命名 为 BootCompleteReceiver， Exported 属性 表示 是 否 
人 允许 这 个 广播 接收 器 接收 本 程序 以 外 的 广播 , EnabtLed 属性 表示 是 否 启 用 这 个 广播 接收 器 。 色 选 
这 两 个 属性 ， 点 击 Finish 完成 创建 。 
然后 修改 BootCompleteReceiver 中 的 代码 ， 如 下 所 示 


public class BootCompleteReceiver extends BroadcastReceiver { 


@Override 
public void onReceive(Context context, Intent intent) { 
Toast.makeText(context, "Boot Complete", Toast.LENGTH LONG).show(); 


} 


} 

代码 非常 简单 ， 我 们 只 是 在 onReceive() 方 法 中 使 用 Toast 弹出 一 段 提 示 信 息 。 

另外 , 静态 的 广播 接收 器 一 定 要 在 AndroidManifest.xml 文件 中 注册 才 可 以 使 用 , 不 过 由 于 我 
们 是 使 用 Android Studio 的 快捷 方式 创建 的 广播 接收 器 ， 因 此 注册 这 一 步 已 经 被 自动 完成 了 。 打 
开 AndroidManifest.xml 文件 瞧 一 瞧 ， 代 码 如 下 所 示 : 


<manifest xmlns:android="http://schemas.android.com/apk/res/android" 
package="com.example.broadcasttest"> 


<uses-permission android:name="android.permission.ACCESS NETWORK _ STATE" /> 


<application 
android:allowBackup="true" 
android:icon="@mipmap/ic launcher" 
android:label="@string/app_name" 
android:supportsRtl="true" 
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android:theme="@style/AppTheme"> 
<receiver 

android:name=" .BootCompleteReceiver" 
android:enabled="true" 
android:exported="true"> 
</receiver> 
</application> 
</manifest> 


可 以 看 到 ，<application> 标 签 内 出 现 了 一 个 新 的 标签 <receiver>， 所 有 静态 的 广播 接收 


器 都 是 在 这 里 进行 注册 的 。 它 的 用 法 其 实 和 <activity> 标 签 非常 相似 , 也 是 通过 android:name 


来 指定 具体 注册 哪 一 个 广播 接收 器 ,而 enabled 和 exported 


属性 则 是 根据 我 们 刚才 色 选 的 状态 
自动 生成 的 。 
不 过 目前 BootCompleteReceiver 还 是 不 能 接收 到 开机 广播 的 ,我 们 还 需要 对 AndroidManifest. 


xml 文件 进行 修改 才 行 ， 如 下 所 示 : 


<manifest xmlns:android="http://schemas.android.com/apk/res/android" 
package="com.example.broadcasttest"> 


<uses-permission android:name="android.permission.ACCESS NETWORK_ STATE" /> 
<uses-permission android:name="android.permission.RECEIVE BOOT_COMPLETED" /> 


<application 
android:allowBackup="true" 
android:icon="@mipmap/ic launcher" 
android:label="@string/app_name" 
android:supportsRtl="true" 
android:theme="@style/AppTheme"> 
<receiver 


android:name=" .BootCompleteReceiver" 
android:enabled="true" 
android:exported="true"> 
<intent-filter> 
<action android:name="android.intent.action.BOOT COMPLETED" /> 
</intent-filter> 
</receiver> 
</application> 


</manifest> 


由 于 Android 系统 启动 完成 后 会 发 出 一 条 值 为 android.intent.action.BOOT COMPLETED 


的 广播 ， 因 此 我 们 在 <intent-filter> 标 签 里 添加 了 相应 的 action。 男 外 ， 监 昕 系统 开机 广播 也 


是 需要 声明 权限 的 ， 可 以 看 到 ， 我 们 使 用 <uses-permission> 标 签 又 加 入 了 一 条 android. 


permission.RECEIVE B00T COMPLETED 权限 。 
现在 重新 运行 程序 后 ， 我 们 的 程序 就 已 经 可 以 接收 开机 广播 了 。 将 模拟 器 关闭 并 重新 启动 ， 


在 启动 完成 之 后 就 会 收 到 开机 广播 ， 如 


图 5.6 所 示 。 
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图 5.6 ”接收 系统 开机 广播 


到 目前 为 止 , 我 们 在 广播 接收 器 的 onReceive() 方 法 中 都 只 是 简单 地 使 用 Toast 提示 了 一 段 
文本 信息 ， 当 你 真正 在 项 目 中 使 用 到 它 的 时 候 ， 就 可 以 在 里 面 编写 自己 的 逻辑 。 需 要 注意 的 是 ， 
不 要 在 onReceive () 方 法 中 添加 过 多 的 逻辑 或 者 进行 任何 的 耗 时 操作 ， 因 为 在 广播 接收 器 中 是 
不 允许 开启 线程 的 ， 当 onReceive( ) 方 法 运行 了 较 长 时 间 而 没有 结束 时 ， 程 序 就 会 报错 。 因 此 
广播 接收 器 更 多 的 是 扮演 一 种 打开 程序 其 他 组 件 的 角色 ,比如 创建 一 条 状态 栏 通知 ， 或 者 启动 一 
个 服务 等 ， 这 几 个 概念 我 们 会 在 后 面 的 章节 中 学 到 。 


5.3 发 送 自 定义 广播 

现在 你 已 经 学 会 了 通过 广播 接收 器 来 接收 系统 广播 , 接 下 来 我 们 就 要 学 习 一 下 如 何在 应 用 程 
序 中 发 送 自 定义 的 广播 。 前 面 已 经 介绍 过 了 , 广播 主要 分 为 两 种 类 型 : 标准 广播 和 有 序 广播 , 在 
本 节 中 我 们 就 将 通过 实践 的 方式 来 看 一 下 这 两 种 广播 具体 的 区 别 。 
5.3.1 发 送 标准 广播 


在 发 送 广播 之 前 , 我 们 还 是 需要 先 定 义 一 个 广播 接收 器 来 准备 接收 此 广播 才 行 , 不 然 发 出 去 
也 是 白 发 。 因 此 新 建 一 个 MyBroadcastReceiver， 代 码 如 下 所 示 : 


public class MyBroadcastReceiver extends BroadcastReceiver { 


@Override 
public void onReceive(Context context, Intent intent) { 
Toast.makeText(context, "received in MyBroadcastReceiver", Toast.LENGTH_ 
SHORT) . show( ); 
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这 里 当 MyBroadcastReceiver 收 到 自 定义 的 广播 时 ， 就 会 弹出 “received in MyBroadcast- 
Receiver” 的 提示 。 然 后 在 AndroidManifest.xml 中 对 这 个 广播 接收 器 进行 修改 : 


<manifest xmlns:android="http://schemas.android.com/apk/res/android" 
package="com.example.broadcasttest"> 


<application 
android:allowBackup="true" 
android:icon="@mipmap/ic launcher" 
android:label="@string/app_name" 
android:supportsRtl="true" 
android:theme="@style/AppTheme"> 


<receiver 
android:name=" .MyBroadcastReceiver" 
android:enabled="true" 
android:exported="true"> 
<intent-filter> 

<action android:name="com.example.broadcasttest.MY_ BROADCAST"/> 

</intent-filter> 

</receiver> 

</application> 
</manifest> 


可 以 看 到 ， 这 里 让 MyBroadcastReceiver 接收 一 条 值 为 com.example.broadcasttest. 
MY_BROADCAST 的 广播 ， 因 此 待 会 儿 在 发 送 广播 的 时 候 ， 我 们 就 需要 发 出 这 样 的 一 条 广播 。 
接 下 来 修改 activity main.xml 中 的 代码 ， 如 下 所 示 : 


<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:orientation="vertical" 
android:layout width="match parent" 
android:layout height="match parent" > 


<Button 
android:id="@+id/button" 
android:layout width="match parent" 
android:layout height="wrap content" 
android:text="Send Broadcast" 
/> 


</LinearLayout> 


这 里 在 布局 文件 中 定义 了 一 个 按钮 ， 用 于 作为 发 送 广播 的 触发 点 。 然 后 修改 MainActivity 中 
的 代码 ， 如 下 所 示 : 


public class MainActivity extends AppCompatActivity { 


@Override 

protected void onCreate(Bundle savedInstanceState) { 
super.onCreate(savedInstanceState);, 
setContentView(R.layout.activity main); 
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Button button = (Button) findViewById(R.id.button) ; 
button.setOnClickListener (new View.0nCLickListener() { 
@Override 
public void onClick(View v) { 
Intent intent = new 
Intent("com.example.broadcasttest.MY BROADCAST"); 
sendBroadcast (intent); 


}); 


可 以 看 到 ， 我们 在 按钮 的 点 击 事件 里 面 加 入 了 发 送 自 定义 广播 的 逻辑 。 首 先 构 建 出 了 一 个 
Intent 对 象 ， 并 把 要 发 送 的 广播 的 值 传 信 ， 然 后 调用 了 Context 的 sendBroadcast() 方 法 将 广 
播发 送出 去 , 这样 所 有 监听 com.example.broadcasttest .MY BROADCAST 这 条 广播 的 广播 接收 
器 就 会 收 到 消息 。 此 时 发 出 去 的 广播 就 是 一 条 标准 广播 。 

重新 运行 程序 ， 并 点 击 一 下 Send Broadcast 按钮 ， 效 果 如 图 5.7 所 示 。 


i 下 737 
BroadcastTest 


SEND BROADCAST 


图 5.7 接收 到 自 定义 广播 
这 样 我 们 就 成 功 完成 了 发 送 自 定义 广播 的 功能 。 另 外 ， 由 于 广播 是 使 用 Intent 进行 传递 的 ， 

因此 你 还 可 以 在 Intent 中 携带 一 些 数据 传递 给 广播 接收 器 。 

5.3.2 发 送 有 序 广播 


广播 是 一 种 可 以 跨 进 程 的 通信 方式 , 这 一 点 从 前 面 接收 系统 广播 的 时 候 就 可 以 看 出 来 了 。 
此 在 我 们 应 用 程序 内 发 出 的 广播 ,其 他 的 应 用 程序 应 该 也 是 可 以 收 到 的 。 为 了 验证 这 一 点 , 我们 
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需要 再 新 建 一 个 BroadcastTest2 项 目 ， 点击 Android Studio 导航 栏 一 File 一 New 一 NewProject 进行 
创建 。 


将 项 目 创 建 好 之 后 , 还 需要 在 这 个 项 目下 定义 一 个 广播 接收 器 , 用 于 接收 上 一 小 节 中 的 自 定 
义 广 播 。 新 建 AnotherBroadcastReceiver， 0 


public class AnotherBroadcastReceiver extends BroadcastReceiver { 


@Override 
public void onReceive(Context context, Intent intent) { 
Toast.makeText(context, "received in AnotherBroadcastReceiver", 
Toast .LENGTH_SHORT) .show(); 


这 里 仍然 是 在 广播 接收 器 的 onReceive() 方 法 中 弹出 了 一 段 文本 信息 。 然 后 在 
AndroidManifest.xml 中 对 这 个 广播 接收 器 进行 修改 ， 代 码 如 下 所 示 : 


<manifest xmlns:android="http://schemas.android.com/apk/res/android" 
package="com.example.broadcasttest2"> 


<application 
android:allowBackup="true" 
android:icon="@mipmap/ic launcher" 
android:label="@string/app_name" 
android:supportsRtl="true" 
android:theme="@style/AppTheme"> 


<receiver 
android:name=" .AnotherBroadcastReceiver" 
android:enabled="true" 
android:exported="true"> 
<intent-filter> 

<action android:name="com.example.broadcasttest.MY_ BROADCAST" /> 

</intent-filter> 

</receiver> 

</application> 


</manifest> 


可 以 看 到 ，AnotherBroadcastReceiver 同样 接收 的 是 com， a broadcasttest.MY 
BROADCAST 这 条 广播 。 现 在 运行 BroadcastTest2 项 目 将 这 个 程序 安装 到 模拟 器 上 ， 然 后 重新 回 到 
BroadcastTest 项 目的 主 界面 ， 并 点 击 一 下 Send Broadcast 按钮 ， 就 会 分 别 弹 出 两 次 提示 信息 ， 如 
图 5.8 所 示 。 
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i 7:58 i 7:58 


BroadcastTest BroadcastTest 


SEND BROADCAST SEND BROADCAST 


received in MyBroadcastReceiver Teceived in AnotherBroadcastReceiver 


4 O 〇 口 4 O 〇 口 


图 5.8 ”两 个 程序 中 都 接收 到 自 定义 广播 
这 样 就 强 有 力 地 证 明了 了， 我们 的 应 用 程序 发 出 的 广播 是 可 以 被 其 他 的 应 用 程序 接收 到 的 。 
不 过 到 目前 为 止 , 程序 里 发 出 的 都 还 是 标准 广播 ,现在 我 们 来 尝试 一 下 发 送 有 序 广播 。 重 新 
回 到 BroadcastTest 项目 ， 然 后 修改 MainActivity 中 的 代码 ， 如 下 所 示 : 


public class MainActivity extends AppCompatActivity { 


@Override 
protected void onCreate(Bundle savedInstanceState) { 
super.onCreate(savedInstanceState); 
setContentView(R.layout.activity main); 
Button button = (Button) findViewById(R.id.button); 
button.setOnClickListener(new View.0nCLickListener() { 
@Override 
public void onClick(View v) { 
Intent intent = new 
Intent("com.example.broadcasttest.MY BROADCAST"); 
sendOrderedBroadcast(intent, null); 


} 


可 以 看 到 ， 发 送 有 序 广播 只 需要 改动 一 行 代 码 ， 即 将 sendBroadcast() 方 法 改 成 send- 
0rderedBroadcast() 方 法 。send0rderedBroadcast() 方 法 接收 两 个 参数 ， 第 一 个 参数 仍然 是 


182 第 5 章 全 局 大 喇叭 


详解 广播 机 制 


Intent， 第 二 个 参数 是 一 个 与 权限 相关 的 字符 串 ， 这 里 传人 null 就 行 了 。 现 在 重新 运行 程序 ， 
并 点 击 Send Broadcast 按钮 ， 你 会 发 现 ， 两 个 应 用 程序 仍然 都 可 以 接收 到 这 条 广播 。 

看 上 去 好 像 和 标准 广播 没什么 区 别 嘛 ,不 过 别 忘 了 , 这 个 时 候 的 广播 接收 器 是 有 先后 顺序 的 ， 
而 且 前 面 的 广播 接收 器 还 可 以 将 广播 截断 ， 以 阻止 其 继续 传播 。 

那么 该 如 何 设 定 广播 接收 器 的 先后 顺序 呢 ? 当然 是 在 注册 的 时 候 进 行 设 定 的 了 ， 修 改 
AndroidManifest.xml 中 的 代码 ， 如 下 所 示 : 


<manifest xmlns:android="http://schemas.android.com/apk/res/android" 
package="com.example.broadcasttest2"> 


<application 
android:allowBackup="true" 
android:icon="@mipmap/ic launcher" 
android:label="@string/app_name" 
android:supportsRtl="true" 
android:theme="@style/AppTheme"> 
<receiver 
android:name=" .MyBroadcastReceiver" 
android:enabled="true" 
android:exported="true"> 
<intent-filter android:priority="100"> 
<action android:name="com.example.broadcasttest.MY BROADCAST" /> 
</intent-filter> 
</receiver> 
</application> 


</manifest> 

可 以 看 到 ， 我 们 通过 android:priority 属性 给 广播 接收 器 设置 了 优先 级 ， 优 先 级 比较 高 
的 广播 接收 器 就 可 以 先 收 到 广播 。 这 里 将 MyBroadcastReceiver 的 优先 级 设 成 了 100, 以 保证 它 一 
定 会 在 AnotherBroadcastReceiver 之 前 收 到 广播 。 

既然 已 经 获得 了 接收 广播 的 优先 权 ， 那 么 MyBroadcastReceiver 就 可 以 选择 是 否 人 允许 广播 继 
续 传 递 了 。 修 改 MyBroadcastReceiver 中 的 代码 ， 如 下 所 示 : 


public cLass MyBroadcastReceiver extends BroadcastReceiver { 


@Override 
public void onReceive(Context context, Intent intent) { 
Toast.makeText(context, "received in MyBroadcastReceiver", 
Toast .LENGTH SHORT).show(); 
abortBroadcast() ; 


} 
如 果 在 onReceive() 方 法 中 调用 了 abortBroadcast () 方 法 , 就 表示 将 这 条 广播 截断 , 后面 
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的 广播 接收 器 将 无 法 再 接收 到 这 条 广播 。 现 在 重新 运行 程序 ， 并 点 击 一 下 Send Broadcast 按钮 ， 
你 会 发 现 ， 只 有 MyBroadcastReceiver 中 的 Toast 信息 能 够 弹出 ,说 明 这 条 广播 经 过 MyBroadcast- 
Receiver 之 后 确实 是 终止 传递 了 。 


5.4 ”使 用 本 地 广播 


前 面 我 们 发 送 和 接收 的 广播 全 部 属于 系统 全 局 广播 , 即 发 出 的 广播 可 以 被 其 他 任何 应 用 程序 
接收 到 ,并 且 我 们 也 可 以 接收 来 自 于 其 他 任何 应 用 程序 的 广播 ,这样 就 很 容易 引起 安全 性 的 问题 ， 
比如 说 我 们 发 送 的 一 些 携带 关键 性 数据 的 广播 有 可 能 被 其 他 的 应 用 程序 截获 , 或 者 其 他 的 程序 不 
停 地 向 我 们 的 广播 接收 器 里 发 送 各 种 垃圾 广播 。 

为 了 能 够 简单 地 解决 广播 的 安全 性 问题 ，Android 引入 了 一 套 本 地 广播 机 制 ， 使 用 这 个 机 制 
发 出 的 广播 只 能 够 在 应 用 程序 的 内 部 进行 传递 , 并 且 广 播 接 收 器 也 只 能 接收 来 自 本 应 用 程序 发 出 
的 广播 ， 这 样 所 有 的 安全 性 问题 就 都 不 存在 了 。 

本 地 广播 的 用 法 并 不 复杂 ， 主 要 就 是 使 用 了 一 个 LocalBroadcastManager 来 对 广播 进行 管理 ， 
并 提供 了 发 送 广播 和 注册 广播 接收 器 的 方法 。 下 面 我 们 就 通过 具体 的 实例 来 尝试 一 下 它 的 用 法 ， 
修改 MainActivity 中 的 代码 ， 如 下 所 示 : 


public class MainActivity extends AppCompatActivity { 


ar 


private IntentFilter intentFilter; 
private LocalReceiver localReceiver; 
private LocalBroadcastManager localBroadcastManager; 


GOverride 
protected void onCreate(Bundle savedInstanceState) { 
super.onCreate(savedInstanceState); 
setContentView(R.layout.activity main); 
LocaLBroadcastManager = LocalBroadcastManager.getInstance(this); // 获取 实例 
Button button = (Button) findViewById(R.id.button); 
button.setOnClickListener(new View.0nCLickListener() { 
@Override 
public void onClick(View v) { 
Intent intent = new Intent("com.example.broadcasttest.LOCAL_ 
BROADCAST"); 
TlocalBroadcastManager.sendBroadcast(intent); // 发 送 本 地 广播 
} 
3 
intentFilter = new IntentFilter(); 
intentFilter.addAction("com.example.broadcasttest.LOCAL BROADCAST"); 
LocaLReceiver = new LocalReceiver(); 
TocalBroadcastManager .registerReceiver(localReceiver, intentFilter); // 注 
册 本 地 广播 监听 器 
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@Override 
protected void onDestroy() { 
super.onDestroy(); 


TocalBroadcastManager .unregisterReceiver (localReceiver); 
} 


class LocalReceiver extends BroadcastReceiver { 


@Override 
public void onReceive(Context context, Intent intent) { 
Toast.makeText(context, "received local broadcast", Toast .LENGTH_SHORT). 
show(); 


} 


有 没有 感觉 这 些 代 码 很 熟悉 ? 没 错 ， 其 实 这 基本 上 就 和 我 们 前 面 所 学 的 动态 注册 广播 接收 器 
以 及 发 送 广播 的 代码 是 一 样 的 。 只 不 过 现在 首先 是 通过 LocalBroadcastManager 的 getInstance() 方 
法 得 到 了 它 的 一 个 实例 ， 然 后 在 注册 广播 接收 器 的 时 候 调用 的 是 LocalBroadcastManager 的 
TE RE ne a) 
方法 ， 仅 此 而 已 。 这 里 我 们 在 按钮 的 点 击 事件 里 面 发 出 了 一 条 com.example.broadcasttest. 
LOCAL_BROADCAST 广播 ,然后 在 LocalReceiver 里 去 接收 这 条 广播 。 重 新 运行 程序 ， 并 点 击 Send 
Broadcast 按钮 ， 效 果 如 图 5.9 所 示 。 


5 8:22 
BroadcastTest 


SEND BROADCAST 


received local broadcast 


| ©] [| 
图 5.9 ”接收 到 本 地 广播 


a 到 ，LocalReceiver 成 功 接收 到 了 这 条 本 地 广播 ， 并 通过 Toast 提示 了 出 来 。 如 果 你 还 
有 兴 行 实验 ， 可 以 尝试 在 BroadcastTest2 中 也 去 接收 com.example.broadcasttest. 
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LOCAL_BROADCAST 这 条 广播 。 答 案 是 显而易见 的 ， 肯 和 定 无 法 收 到 ， 因 为 这 条 广播 只 会 在 
BroadcastTest 程序 内 传播 。 

另外 还 有 一 点 需要 说 明 , 本 地 广播 是 无 法 通过 静态 注册 的 方式 来 接收 的 。 其 实 这 也 完全 可 以 
理解 ， 因 为 静态 注册 主要 就 是 为 了 让 程序 在 未 启动 的 情况 下 也 能 收 到 广播 ， 而 发 送 本 地 广播 时 ， 
我 们 的 程序 肯定 是 已 经 启动 了 ， 因 此 也 完全 不 需要 使 用 静态 注册 的 功能 。 

最 后 我 们 再 来 盘点 一 下 使 用 本 地 广播 的 几 点 优势 吧 。 
口 可 以 明确 地 知道 正在 发 送 的 广播 不 会 离开 我 们 的 程序 ， 因 此 不 必 担 心机 密 数 据 泄漏 。 
口 其 他 的 程序 无 法 将 广播 发 送 到 我 们 程序 的 内 部 ， 因 此 不 需要 担心 会 有 安全 漏洞 的 隐患 
口 发 送 本 地 广播 比 发 送 系 统 全 局 广播 将 会 更 加 高 效 。 
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本 章 的 内 容 不 是 非常 多 , 因此 相信 你 也 一 定 学 得 很 轻松 吧 。 现在 我 们 就 准备 通过 一 个 完整 例 
子 的 实践 ， 来 综合 运用 一 下 本 章 中 所 学 到 的 知识 。 

强制 下 线 功 能 应 该 算是 比较 常见 的 了 , 很 多 的 应 用 程序 都 具备 这 个 功能 ， 比 如 你 的 QQ 号 在 
别处 登录 了 ， 就 会 将 你 强制 挤 下 线 。 其 实 实现 强制 下 线 功 能 的 思路 也 比较 简单 ， 只 需要 在 界面 上 
单 出 一 个 对 话 框 ,让 用 户 无 法 进行 任何 其 他 操作 ， 必 须要 点 击 对 话 框 中 的 确定 按钮 ,然后 回 到 登 
录 界 面 即 可 。 可 是 这 样 就 存在 着 一 个 问题 , 因为 当 我 们 被 通知 需要 强制 下 线 时 可 能 正 处 于 任何 一 
个 界面 , 难道 需要 在 每 个 界面 上 都 编写 一 个 弹出 对 话 框 的 逻辑 ? 如 果 你 真 的 这 么 想 , 那 思维 就 偏 
远 了 ， 我 们 完全 可 以 借助 本 章 中 所 学 的 广播 知识 ， 来 非常 轻松 地 实现 这 一 功能 。 新 建 一 个 
BroadcastBestPractice 项 目 ， 然 后 开始 动手 吧 。 

强制 下 线 功 能 需要 先 关 闭 掉 所 有 的 活动 ,然后 回 到 登录 界面 。 如 果 你 的 反应 足够 快 的 话 ,， 应 
该 会 想到 我 们 在 第 2 章 的 最 佳 实践 部 分 早 就 已 经 实现 过 关闭 所 有 活动 的 功能 了 , 因此 这 里 只 需要 
使 用 同样 的 方案 即 可 。 先 创建 一 个 ActivityCollector 类 用 于 管理 所 有 的 活动 , 代码 如 下 所 示 


public class ActivityCollector { 


0 


re 


public static List<Activity> activities = new ArrayList<>(); 


public static void addActivity(Activity activity) { 
activities.add(activity); 
} 


public static void removeActivity(Activity activity) { 
activities.remove(activity); 


} 


public static void finishALL() { 
for (Activity activity : activities) { 
if (!activity. isFinishing()) { 
activity.finish(); 
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activities.clear(); 


} 
然后 创建 BaseActivity 类 作为 所 有 活动 的 父 类 ， 代 码 如 下 所 示 : 


public class BaseActivity extends AppCompatActivity { 


@Override 

protected void onCreate(Bundle savedInstanceState) { 
super.onCreate(savedInstanceState); 
ActivityCollector.addActivity(this); 

} 


@Override 

protected void onDestroy() { 
super.onDestroy(); 
ActivityCollector. removeActivity(this); 


} 

以 上 代码 都 是 直接 拿 之 前 写 好 的 内 容 , 非常 开心 。 不 过 从 这 里 开始 ,就 要 靠 我 们 自己 去 动手 
实现 了 。 首 先 需 要 创建 一 个 登录 界面 的 活动 ， 新 建 LoginActivity， 并 让 Android Studio 帮 我 们 自 
动 生 成 相应 的 布局 文件 。 然 后 编辑 布局 文件 activity_login.xml， 代 码 如 下 所 示 : 


<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:orientation="vertical" 
android:layout width="match parent" 
android:layout height="match parent"> 


<LinearLayout 

android:orientation="horizontal" 

android:layout width="match parent" 

android:layout height="60dp"> 

<TextView 
android:layout width="90dp" 
android:layout height="wrap content" 
android:layout gravity="center vertical" 
android:textSize="18sp" 
android:text="Account:" /> 


<EditText 
android:id="@+id/account" 
android:Layout width="0dp" 
android:layout height="wrap content" 
android:layout weight="1" 
android:Layout gravity="center vertical" /> 
</LinearLayout> 


<LinearLayout 
android:orientation="horizontal" 
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android:layout width="match parent" 


android:layout height="60dp"> 


<TextView 
android: layout width="90dp" 
android:layout height="wrap content" 
android:layout gravity="center vertical" 
android:textSize="18sp" 
android:text="Password:" /> 
<EditText 
android:id="@+id/password" 
android:layout width="0dp" 
android:layout height="wrap content" 
android:layout weight="1" 
android:Layout gravity="center vertical" 
android:inputType="textPassword" /> 
</LinearLayout> 
<Button 


android:id="@+id/login" 


android:layout width="match parent" 


android:layout height="60dp" 
android:text="Login" /> 


</LinearLayout> 


这 里 我 们 使 用 LinearLayout 编写 出 了 一 个 登录 布局 ， 最 外 层 是 一 个 纵向 的 LinearLayout， 里 


面包 含 了 3 行 直接 子 元 素 。 第 一 行 是 一 个 横向 LinearLayout， 用 于 输入 账号 信息 ; 


RE 


个 横向 的 LinearLayout， 用 于 输入 密码 信息 ; 第 


A 


是 


第 二 行 也 是 一 
个 登录 按钮 。 这 个 布局 文件 里 面 用 到 的 


全 部 都 是 我 们 之 前 学 过 的 内 容 ， 相 信 你 理解 起 来 应 该 不 会 费劲 。 
接 下 来 修改 LoginActivity 中 的 代码 ， 如 下 所 示 : 


public class LoginActivity extends BaseActivity { 


private EditText accountEdit; 
private EditText passwordEdit; 
private Button login; 


@Override 


protected void onCreate(Bundle savedInstanceState) { 
super.onCreate(savedInstanceState); 
setContentView(R.layout.activity login); 


accountEdit = (EditText) findViewById(R.id.account); 
passwordEdit = (EditText) findViewById(R.id.password); 
Login = (Button) findViewById(R.id.Tlogin); 


Togin.setOnClickListener(new View.OnClickListener() { 


@Override 


public void onClick(View v) { 


String account 


accountEdit.getText().toString(); 
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}); 


这 里 我 们 模拟 了 一 


BaseActivity, 然后 调 月 


String password = passwordEdit.getText().toString(); 
// 如 果 账 号 是 admin 且 密 码 是 123456， 就 认为 登录 成 功 
if (account.equals("admin") && password.equals("123456")) { 
Intent intent = new Intent(LoginActivity.this, MainActivity. 
class); 
startActivity(intent); 
finish(); 
} else { 
Toast.makeText(LoginActivity.this, "account or password is 
invalid", Toast.LENGTH SHORT).show(); 


密码 是 123456， 就 认为 登录 成 功 并 跳 转 到 MainActivity， 否 则 就 提示 用 户 账号 或 密码 错误 。 


因此 ， 你 就 可 以 将 MainActivity 型 


中 的 代码 ， 如 下 所 示 : 


<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:orientation="vertical" 
android:layout width="match parent" 
android:layout height="match parent" > 


<Button 
android: 
android: 
android: 
android: 


</LinearLayout> 


id="@+id/force offline" 

layout width="match parent" 

layout height="wrap_content" 
text="Send force offline broadcast" /> 


非常 简单 ， 只 有 一 


如 下 所 示 : 


个 按钮 而 已 ， 用 于 触发 强制 下 线 功 能 。 然 后 修改 MainActivity 中 的 代码 ， 


public class MainActivity extends BaseActivity { 


@Override 


protected void onCreate(Bundle savedInstanceState) { 


super.on 
setConte 
Button f 
force0ff 


Create(SavedInstanceState ) ; 
ntView(R.Layout,activity main); 

orceoffLine = (Button) findViewById(R.id.force offline); 
line.setOnClickListener(new View.0nCLickListener() { 


@Override 


个 非常 简单 的 登录 功能 。 首 先 要 将 LoginActivity 的 继承 结构 改 成 继承 自 
日 findViewById() 方 法 分 别 获取 到 账号 输入 框 、 密 码 输入 框 以 及 登录 按钮 
的 实例 。 接 着 在 登录 按钮 的 点 击 事件 里 面 对 输 入 的 账号 和 密码 进行 判断 ， 如 果 账 号 是 admin 并 且 


解 成 是 登录 成 功 后 进入 的 程序 主 界面 了 ， 这 里 我 们 并 不 需 
要 在 主 界面 里 提供 什么 花哨 的 功能 ， 只 需要 加 入 强制 下 线 功 能 就 可 以 了 ， 修 改 activity_main.xml 
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public void onClick(View v) { 
Intent intent = new Intent("com.example.broadcastbestpractice. 
FORCE_OFFLINE"); 
sendBroadcast (intent); 


}); 


同样 非常 简单 ,不 过 这 里 有 个 重点 , 我们 在 按钮 的 点 击 事件 里 面 发送 了 一 条 广播 , 广播 的 值 
为 com.example.broadcastbestpractice.FORCE OFFLINE， 这 条 广播 就 是 用 于 通知 程序 强制 
用 户 下 线 的 。 也 就 是 说 强制 用 户 下 线 的 逻辑 并 不 是 写 在 MainActivity 里 的 ， 而 是 应 该 写 在 接收 这 
条 广播 的 广播 接收 器 里 面 , 这 样 强制 下 线 的 功能 就 不 会 依附 于 任何 的 界面 , 不 管 是 在 程序 的 任何 
地 方 ， 只 需要 发 出 这 样 一 条 广播 ， 就 可 以 完成 强制 下 线 的 操作 了 。 

那么 毫 无 疑问 , 接 下 来 我 们 就 需要 创建 一 个 广播 接收 器 来 接收 这 条 强制 下 线 广播 , 唯一 的 问 
题 就 是 ， 应 该 在 哪里 创建 呢 ? 由 于 广播 接收 器 里 面 需要 弹出 一 个 对 话 框 来 阻塞 用 户 的 正常 操作 ， 
但 如 果 创 建 的 是 一 个 静态 注册 的 广播 接收 器 ， 是 没有 办 法 在 onReceive() 方 法 里 弹出 对 话 框 这 
样 的 UI 控 件 的 ， 而 我 们 显然 也 不 可 能 在 每 个 活动 中 都 去 注册 一 个 动态 的 广播 接收 需 。 

那么 到 底 应 该 怎么 办 呢 ? 答案 其 实 很 明显 ， 只 需要 在 BaseActivity 中 动态 注册 一 个 广播 接收 
器 就 可 以 了 ， 因 为 所 有 的 活动 都 是 继承 自 BaseActivity 的 。 

修改 BaseActivity 中 的 代码 ， 如 下 所 示 : 


public class BaseActivity extends AppCompatActivity { 


Ht 


private Force0ffLineReceiver receiver; 


@Override 

protected void onCreate(Bundle savedInstanceState) { 
super.onCreate(savedInstanceState); 
ActivityCollector.addActivity(this); 

} 


@Override 

protected void onResume() { 
super .onResume(); 
IntentFilter intentFilter = new IntentFilter(); 
intentFilter.addAction("com.example.broadcastbestpractice.FORCE OFFLINE"); 
receiver = new Force0ffLineReceliver() ; 
registerReceiver(receiver, intentFilter); 


} 


@Override 
protected void onPause() { 
super .onPause(); 
if (receiver != nuLL) { 
unregisterReceiver(receiver); 
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receiver = null; 


} 


@Override 
protected void onDestroy() { 
super.onDestroy(); 
ActivityCollector. removeActivity(this); 
} 


class Force0ffLineReceiver extends BroadcastReceiver { 


@Override 
public void onReceive(final Context context, Intent intent 


) +{ 


AlertDialog.Builder builder = new AlertDialog.Builder(context); 


builder.setTitle("Warning"); 


builder.setMessage("You are forced to be offline. Please try to login 


again."); 
builder.setCancelable (false); 


builder.setPositiveButton("0K", new DialogInterface.OnClickListener() { 


@Override 


public void onClick(DialogInterface dialog, int which) { 


ActivityCoLLector.finishALL(); // 销毁 所 有 活动 


Intent intent = new Intent(context, LoginActivity.class); 
context.startActivity(intent); // 重新 启动 LoginActivity 


} 
}); 
builder. show(); 


} 


先 来 看 一 下 ForceOfflineReceiver 中 的 代码 ， 这 次 onReceive() 方 法 里 可 不 再 是 仅仅 弹出 一 
个 Toast 了， 而 是 加 入 了 和 较 多 的 代码 ， 那 我 们 就 来 仔细 地 看 看 吧 。 首 先 肯定 是 使 用 
AlertDialog.Builder 来 构建 一 个 对 话 框 , 注意 这 里 一 定 要 调用 setCancelable() 方 法 将 对 话 


框 设 为 不 可 取消 ， 否 则 用 户 按 一 下 Back 键 就 可 以 关闭 对 话 框 继续 使 用 程序 了 。 然 后 使 用 


setPositiveButton() 方 法 来 给 对 话 框 注册 确定 按钮 ， 当 用 户 点 击 了 确定 按钮 时 ， 就 调用 

ActivityCollector 的 finishALL() 方 法 来 销毁 掉 所 有 活动 ， 并 重新 启动 LoginActivity 这 个 活动 。 
再 来 看 一 下 我 们 是 怎么 注册 ForceOfflineReceiver 这 个 广播 接收 器 的 , 可 以 看 到 , 这 里 重 写 了 

onResume() 和 onPause() 这 两 个 生命 周期 也 数 ， 然 后 分 别 在 这 两 个 方法 里 注册 和 取消 注册 了 


ForceOfflineRecelver。 


那么 为 什么 要 这 样 写 呢 ? 之 前 不 都 是 在 onCreate() 和 onDestroy() 方 法 里 来 注册 和 取消 注 
册 广 播 接收 器 的 么 ?” 这 是 因为 我 们 始终 需要 保证 只 有 处 于 栈 顶 的 活动 才能 接收 到 这 条 强制 下 线 


广播 ， 非 栈 项 的 活动 不 应 该 也 没有 必要 去 接收 这 条 广播 ， 所 以 写 在 onResume ( 


) 和 onPause() 方 


法 里 就 可 以 很 好 地 解决 这 个 问题 ， 当 一 个 活动 失去 栈 顶 位 置 时 就 会 自动 取消 广播 接收 需 的 注册 。 
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这 样 的 话 ， 所 有 强制 下 线 的 逻辑 就 已 经 完成 了 ， 接 下 来 我 们 还 需要 对 AndroidManifest.xml 
文件 进行 修改 ， 代 码 如 下 所 示 : 


<manifest xmlns:android="http://schemas.android.com/apk/res/android" 
package="com.example.broadcastbestpractice"> 


<application 
android:allowBackup="true" 
android:icon="@mipmap/ic launcher" 
android:label="@string/app_name" 
android:supportsRtl="true" 
android:theme="@style/AppTheme"> 
<activity android:name=".MainActivity"> 
</activity> 
<activity android:name=".LoginActivity"> 
<intent-filter> 
<action android:name="android.intent.action.MAIN" /> 
<category android:name="android.intent.category.LAUNCHER" /> 
</intent-filter> 
</activity> 
</application> 


</manifest> 


里 只 需要 对 一 处 代码 进行 修改 ,就 是 将 主 活动 设置 为 LoginActivity 而 不 再 是 MainActivity ， 
a 6 直接 进入 到 程序 主 界 面 吧 ? 
好 了 , 现在 来 尝试 运行 一 下 程序 吧 , 首先 会 进入 到 登录 界面 , 并 可 以 在 这 里 输入 账号 和 密码 ， 


如 图 5.10 所 示 。 


Account admin 


LOGIN 


本 O 〇 口 


图 5.10 登录 界面 
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如 果 输 入 的 账号 是 admin， 密 码 是 123456， 点 击 登录 按钮 就 会 进入 到 程序 的 主 界面 ， 如 图 
5.11 所 示 。 这 时 点 击 一 下 发 送 广播 的 按钮 ， 就 会 发 出 一 条 强制 下 线 的 广播 ，ForceOfflineReceiver 
里 收 到 这 条 广播 后 会 弹出 一 个 对 话 框 提示 用 户 已 被 强制 下 线 ， 如 图 5.12 所 示 。 


BroadcastBestPractice 


SEND FORCE OFFLINE BROADC, AST 
Warning 
You are forced to be offline. Please try to 
login again, 
O 〇 口 
图 5.11 主 界面 图 5.12 ”强制 下 线 提示 


这 时 用 户 将 无 法 再 对 界面 的 任何 元 素 进 行 操作 ,只 能 点 击 确定 按钮 , 然后 会 重新 加 到 登录 界 
面 。 这 样 ， 强 制 下 线 功能 就 已 经 完整 地 实现 了 。 

结束 了 本 章 的 最 佳 实践 部 分 ， 接 下 来 我 们 要 进入 一 个 特殊 的 环节 。 相 信 你 一 定 也 知道 ， 几 乎 
所 有 出 色 的 项 目 都 不 会 是 由 一 个 人 单枪匹马 完成 的 , 而 是 由 一 个 团队 共同 合作 开发 完成 的 。 这 个 
时 候 多 人 之 间 代 码 同步 的 问题 就 显得 异常 重要 , 因此 版 本 控制 工具 也 就 应 运 而 生 了 。 常见 的 版 本 
控制 工具 主要 有 svn 和 Git, 本 书 中 将 会 对 Git 的 使 用 方法 进行 全 面 的 讲解 , 并 且 讲 解 的 内 容 是 穿 
插 于 一 些 章节 当中 的 。 那 么 今天 ， 我 们 就 先 来 看 一 看 关于 Git 最 基本 的 用 法 。 


5.6 ”Git 时 间 初 识 版 本 控制 工具 


Git 是 一 个 开源 的 分 布 式 版 本 控制 工具 ， 它 的 开发 者 就 是 易 易 大 名 的 Linux 操作 系统 的 作者 
Linus Torvalds。Git 被 开发 出 来 的 初衷 是 为 了 更 好 地 管理 Linux 内 核 ， 而 现在 却 早已 被 广泛 应 用 
于 全 球 各 种 大 中 小 型 的 项 目 中 。 今天 是 我 们 关于 Git 的 第 一 堂 课 ， 主 要 是 讲解 一 下 它 最 基本 的 用 
法 ， 那 么 就 从 安装 Git 开始 吧 。 


5.6.1 安装 Git 
由 于 Git 和 Linux 操作 系统 都 是 同一 个 作者 , 因此 不 用 我 说 , 你 也 应 该 猪 到 Git 在 Linux 上 的 
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安装 是 最 简单 方便 的 。 比 如 你 使 用 的 是 Ubuntu 系统 ， 只 需要 打开 shell 界面 ， 并 输入 : 

sudo apt-get install git-core 

按 下 回 车 后 输入 密码 ， 即 可 完成 Git 的 安装 。 

不 过 我 相信 你 更 有 可 能 使 用 的 还 是 Windows 操作 系统 ， 因 此 本 小 节 的 重点 是 教会 你 如 何在 
Windows 上 安装 Git。 不 同 于 Linux, Windows 上 可 无 法 通过 一 行 命令 就 完成 安装 了 , 我 们 需要 先 
把 Git 的 安装 包 下 载 下 来 。 访 问 网 址 https://git-for-windows.github.io/， 可 以 看 到 如 图 5.13 所 示 的 
页 面 。 


git for windows 
VERSION 2.8.1 


We bring the 
awesome Git SCM to 
Windows 


图 5.13 ”git for windows 主页 


目前 最 新 的 git for windows 版 本 是 2.8.1, 我 就 准备 使 用 这 一 版 本 了 ,如果 你 下 载 的 时 候 发 现 
又 有 新 的 版 本 , 可 以 尝试 一 下 最 新 版 本 的 Git。 点 击 Download 按钮 可 以 开始 下 载 , 下 载 完成 后 双 
击 安装 包 进 行 安装 ， 之 后 一 直 点 击 “下 一 步 ”就 可 以 完成 安装 了 。 


5.6.2 创建 代码 仓库 


虽然 在 Windows 上 安装 的 Git 是 可 以 在 图 形 界面 上 进行 操作 的 ， 并 且 Android Studio 也 支持 
以 图 形 化 的 形式 操作 Git， 但 是 这 里 我 并 不 建议 你 这 样 做 ， 因 为 Git 的 各 种 命令 才 是 你 应 该 掌握 
的 核心 技能 ,不管 你 是 在 哪个 操作 系统 中 ， 使 用 命令 来 操作 Git 肯定 都 是 通用 的 。 而 图 形 化 的 操 
作 应 该 是 在 你 能 熟练 掌握 命令 用 法 的 前 提 下 ， 进 一 步 提升 你 工作 效率 的 手段 。 

那么 我 们 现在 就 来 尝试 一 下 如 何 通过 命令 来 使 用 Git。 如 果 你 使 用 的 是 Linux 系统 ， 就 先 打 
开 shell 界面 ， 如 果 使 用 的 是 Windows 系统 ， 就 从 开始 里 找到 Git Bash 并 打开 。 

首先 应 该 配置 一 下 你 的 身份 ， 这 样 在 提交 代码 的 时 候 Git 就 可 以 知道 是 谁 提交 的 了 ， 命 令 如 
下 所 示 : 


git config --global user.name "Tony" 
git config --global user.email "tony@gmail.com" 


配置 完成 后 你 还 可 以 使 用 同样 的 命令 来 查看 是 否 配 置 成 功 , 只 需要 将 最 后 的 名 字 和 邮箱 地 址 
去 掉 即 可 ， 如 图 5.14 所 示 。 
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图 5.14 查看 git 用 户 名 和 邮箱 
然后 我 们 就 可 以 开始 创建 代码 仓库 了 ,仓库 ( Repository ) 是 用 于 保存 版 本 管理 所 需 信 息 自 
地 方 ， 所 有 本 地 提交 的 代码 都 会 被 提交 到 代码 仓库 中 ， 如 果 有 需要 还 可 以 再 推送 到 远程 iy 


这 里 我 们 尝试 着 给 BroadcastBestPractice 项 目 建 立 一 个 代码 仓库 。 先 进入 到 BroadcastBest- 
Practice 项 目的 目录 下 面 ， 如 图 5.15 所 示 。 


图 5.15 切换 到 BroadcastBestPractice 项 目 目录 下 
然后 在 这 个 目录 下 面 输入 如 下 命令 : 
git init 


很 简单 吧 ! 只 需要 一 行 命令 就 可 以 完成 创建 代码 仓库 的 操作 ， 如 图 5.16 所 示 。 


图 5.16 创建 代码 仓库 
仓库 创建 完成 后 ， 会 在 BroadcastBestPractice 项 目的 根 目录 下 生成 一 个 隐藏 的 .git 文件 夹 ， 
文 个 文件 夹 就 是 用 来 记录 本 地 所 有 的 Git 操作 的 , 可 以 通过 Ls -at 命令 来 查看 一 下 , 如 图 5.17 
所 示 。 


图 5.17 查看 .git 文 件 
如 果 你 想 要 删除 本 地 仓库 ， 只 需要 删除 这 个 文件 夹 就 行 了 。 
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5.6.3 ”提交 本 地 代码 

代码 仓库 建立 完 之 后 就 可 以 提交 代码 了 ， 其 实 提交 代码 的 方法 也 非常 简单 ， 只 需要 使 用 add 
和 commit 命令 就 可 以 了 。add 用 于 把 想 要 提交 的 代码 先 添 加 进来 ， 而 commit 则 是 真正 地 去 执 
行 提 交 操 作 。 比 如 我 们 想 添 加 build.gradle 文件 ， 就 可 以 输入 如 下 命令 : 

git add build.gradle 

这 是 添加 单个 文件 的 方法 , 那 如 果 我 们 想 添 加 某 个 目录 呢 ? 其 实 只 需要 在 add 后 面 加 上 目录 
名 就 可 以 了 。 比 如 将 整个 app 目录 下 的 所 有 文件 都 进行 添加 ， 就 可 以 输入 如 下 命令 : 

git add app 

可 是 这 样 一 个 个 地 添加 感觉 还 是 有 些 复杂 , 有 没有 什么 办 法 可 以 一 次 性 就 把 所 有 的 文件 都 添 
加 好 呢 ? 当然 可 以 , 只 需要 在 add 的 后 面 加 上 一 个 点 , 就 表示 添加 所 有 的 文件 了 , 命令 如 下 所 示 : 

git add ， 

现在 BroadcastBestPractice 项 目下 所 有 的 文件 都 已 经 添加 好 了 ， 我 们 可 以 来 提交 一 下 了 ， 输 
人 如 下 命令 : 

git commit -m "First commit." 

注意 , 在 commit 命令 的 后 面 , 我 们 一 定 要 通过 -m 参数 来 加 上 提交 的 描述 信息 , 没有 描述 信 
息 的 提交 被 认为 是 不 合法 的 。 这 样 所 有 的 代码 就 已 经 成 功 提交 了 1! 

好 了 ， 关 于 Git 的 内 容 ， 今 天 我 们 就 学 到 这 里 ， 虽 然 内 容 并 不 多 ， 但 是 你 已 经 将 Git 最 基本 
的 用 法 都 掌握 了 ， 不 是 吗 ? 在 本 书后 面 的 章节 ， 还 会 穿插 一 些 Git 的 讲解 ， 到 时 候 你 将 学 会 更 多 
关于 Git 的 使 用 技巧 ， 现 在 就 让 我 们 来 总 结 一 下 吧 
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本 章 中 我 们 主要 是 对 Android 的 广播 机 制 进行 了 深入 的 研究 ， 不仅 了 解 了 广播 的 理论 知识 ， 
还 掌握 了 接收 广播 、 发 送 自 定义 广播 以 及 本 地 广播 的 使 用 方法 。 广 播 接收 器 属于 Android 四 大 组 
件 之 一 ， 在 不 知 不 觉 中 你 已 经 掌握 了 四 大 组 件 中 的 两 个 了 。 

在 最 佳 实践 环节 中 你 一 定 也 收获 了 不 少 , 不 仅 运 用 到 了 本 章 所 学 的 广播 知识 , 还 将 前 面 章节 
所 学 到 的 技巧 综合 运用 到 了 一 起 。 经 过 这 个 例子 之 后 , 相信 你 对 所 涉及 的 每 个 知识 点 都 有 了 更 深 
一 层 的 认识 。 男 外 ， 本 章 还 添加 了 一 个 最 最 特殊 的 环节 ， 即 Git 时 间 。 在 这 个 环节 中 ， 我 们 对 
Git 这 个 版 本 控制 工具 进行 了 初步 的 学 习 ， 后 面 还 会 学 习 关 于 它 的 更 多 内 容 。 

下 一 章 我 们 本 应 该 继续 学 习 Android 四 大 组 件 中 的 内 容 提 供 器 ,不 过 由 于 学 习 内 容 提 供 器 之 
前 需要 先 掌 握 Android 中 的 持久 化 技术 ， 因 此 下 一 章 我 们 就 先 对 这 一 主题 展开 讨论 。 
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任何 一 个 应 用 程序 ,其 实说 白 了 就 是 在 不 停 地 和 数据 打交道 , 我们 聊 QQ、 看 新 闻 、 刷 微 博 ， 
所 关心 的 都 是 里 面 的 数据 , 没有 数据 的 应 用 程序 就 变 成 了 一 个 空 帝 子 , 对 用 户 来 说 没有 任何 实际 
用 途 。 那 么 这 些 数 据 都 是 从 哪 来 的 呢 ? 现在 多 数 的 数据 基本 都 是 由 用 户 产生 的 ， 比 如 你 发 微 博 、 
评论 新 闻 ， 其 实 都 是 在 产生 数据 。 

而 我 们 前 面 章节 所 编写 的 众多 例子 中 也 有 用 到 各 种 各 样 的 数据 , 例如 第 3 章 最 佳 实践 部 分 在 
聊天 界面 编写 的 聊天 内 容 , 第 5 章 最 佳 实践 部 分 在 登录 界面 输入 的 账号 和 密码 。 这 些 数据 都 有 一 
个 共同 点 ， 即 它们 都 属于 瞬时 数据 。 那 么 什么 是 瞬时 数据 呢 ? 就 是 指 那些 存储 在 内 存 当 中 ,有 可 
能 会 因为 程序 关闭 或 其 他 原因 导致 内 存 被 回收 而 丢失 的 数据 。 这 对 于 一 些 关 键 性 的 数据 信息 来 
说 是 绝对 不 能 容忍 的 ， 谁 都 不 希望 自己 刚 发 出 去 的 一 条 微 博 ,刷新 一 下 就 没 了 吧 。 那 么 怎样 才能 
保证 一 些 关 键 性 的 数据 不 会 丢失 呢 ? 这 就 需要 用 到 数据 持久 化 技术 了 。 


6.1 持久 化 技术 简介 


数据 持久 化 就 是 指 将 那些 内 存 中 的 瞬时 数据 保存 到 存储 设备 中 , 保证 即使 在 手机 或 电脑 关机 
的 情况 下 ,这 些 数据 仍然 不 会 丢失 。 保存 在 内 存 中 的 数据 是 处 于 瞬时 状态 的 ,而 保存 在 存储 设备 
中 的 数据 是 处 于 持久 状态 的 , 持久 化 技术 则 提供 了 一 种 机 制 可 以 让 数据 在 瞬时 状态 和 持久 状态 之 
间 进 行 转换 。 

持久 化 技术 被 广泛 应 用 于 各 种 程序 设计 的 领域 当中 ,而 本 书 中 要 探讨 的 自然 是 Android 中 的 
数据 持久 化 技术 。Android 系统 中 主要 提供 了 3 种 方式 用 于 简单 地 实现 数据 持久 化 功能 ， 即 文件 
存储 、SharedPreferences 存储 以 及 数据 库存 储 。 当 然 ， 除 了 这 3 种 方式 之 外 ， 你 还 可 以 将 数据 保 
存在 手机 的 SD 卡 中 , 不 过 使 用 文件 、SharedPreferences 或 数据 库 来 保存 数据 会 相对 更 简单 一 些 ， 
而 且 比 起 将 数据 保存 在 SD 卡 中 会 更 加 地 安全 。 


那么 下 面 我 就 将 对 这 3 种 数据 持久 化 的 方式 一 一 进行 详细 的 讲解 。 
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6.2 文件 存储 


文件 存储 是 Android 中 最 基本 的 一 种 数据 存储 方式 , 它 不 对 存储 的 内 容 进 行 任何 的 格式 化 处 
理 , 所 有 数据 都 是 原封 不 动 地 保存 到 文件 当中 的 , 因而 它 比 较 适合 用 于 存储 一 些 简 单 的 文本 数据 
或 二 进 制 数据 。 如 果 你 想 使 用 文件 存储 的 方式 来 保存 一 些 较为 复杂 的 文本 数据 , 就 需要 定义 一 套 
自己 的 格式 规范 ， 这 样 可 以 方便 之 后 将 数据 从 文件 中 重新 解析 出 来 。 

那么 首先 我 们 就 来 看 一 看 ，Android 中 是 如 何 通 过 文件 来 保存 数据 的 。 


6.2.1 将 数据 存储 到 文件 中 


Context 类 中 提供 了 一 个 openFile0utput() 方 法 ， 可 以 用 于 将 数据 存储 到 指定 的 文件 中 。 
这 个 方法 接收 两 个 参数 ,第 一 个 参数 是 文件 名 , 在 文件 创建 的 时 候 使 用 的 就 是 这 个 名 称 ， 注意 这 
里 指定 的 文件 名 不 可 以 包含 路 径 ， 为 所 有 的 文件 都 是 默认 存储 到 /data/data/<package 
name>/files/ 目 录 下 的 。 第 二 个 参数 是 文件 的 操作 模式 ， 主 要 有 两 种 模式 可 选 ，MODE _ PRIVATE 
和 MODE APPEND。 其 中 MODE _ PRIVATE 是 默认 的 操作 模式 , 表示 当 指 定 同 样 文件 名 的 时 候 ， 
所 写 入 的 内 容 将 会 履 盖 原文 件 中 的 内 容 ， 而 MODE_APPEND 则 表示 如 果 该 文件 已 存在 ， 就 往 文 
件 里 面 追 加 内 容 ， 不 存在 就 创建 新 文件 。 其 实 文件 的 操作 模式 本 来 还 有 另外 两 种 : 
MODE WORLD READABLE 和 MODE WORLD WRITEABLE, 这 两 种 模式 表示 允许 其 他 的 应 
用 程序 对 我 们 程序 中 的 文件 进行 读 写 操作 , 不 过 由 于 这 两 种 模式 过 于 危险 , 很 容易 引起 应 用 的 安 
全 性 漏洞 ， 已 在 Android 4.2 版 本 中 被 废弃 。 
openFile0utput () 方 法 返回 的 是 一 个 File0utputStream 对 象 ， 得 到 了 这 个 对 象 之 后 就 
可 以 使 用 Java 流 的 方式 将 数据 写 人 到 文件 中 了 。 以 下 是 一 段 简单 的 代码 示例 ， 展 示 了 如 何 将 一 
段 文本 内 容 保存 到 文件 中 : 
public void save() { 
String data = "Data to save"; 
FileOutputStream out = null; 


BufferedWriter writer = null; 
try { 
out = openFileOutput("data", Context.MODE PRIVATE); 
writer = new BufferedWriter(new OutputStreamWriter(out)); 
writer.write(data); 
} catch (IOException e) { 
e.printStackTrace(); 
} finally { 
try { 
if (writer != null) { 
writer.close(); 


} 
} catch (IOException e) { 
e.printStackTrace(); 
} 
} 
} 


A 
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如 果 你 已 经 比较 熟悉 Java 流 了 ， 理 解 上 面 的 代码 一 定 轻而易举 吧 。 这 里 通过 openFile- 
Output () 方 法 能 够 得 到 一 个 File0utputStream 对 象 ， 然 后 再 借助 它 构建 出 一 个 0utput- 
StreamWriter 对 象 , 接着 再 使 用 0utputStreamWriter 构建 出 一 个 BufferedWriter 对 象 , 这 


样 你 就 可 以 通过 Bufferedwriter 来 将 文本 内 容 写 入 到 文件 中 了 。 


下 面 我 们 就 编写 一 个 完整 的 例子 , 借 此 学 习 一 下 如 何在 Android 项 目 中 使 用 文件 存储 的 技术 。 


首先 创建 一 个 FilePersistenceTest 项 目 ， 并 修改 activity main.xml 中 的 代码 ， 如 下 所 示 


<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 


android:orientation="vertical" 
android:layout width="match parent" 
android:layout height="match parent" > 


<EditText 
android:id="@+id/edit" 
android:layout width="match parent" 
android:layout height="wrap content" 
android:hint="Type something here" 
/> 


</LinearLayout> 


这 里 只 是 在 布局 中 加 入 了 一 个 EditText， 用 于 输入 文本 内 容 。 其 实现 在 你 就 可 以 运行 一 下 程 


序 了 , 界面 上 肯定 会 有 一 个 文本 输入 框 。 然后 在 文本 输入 框 中 随意 输入 点 什么 内 容 ， 


再 按 下 Back 
键 ， 这 时 输入 的 内 容 肯 定 就 已 经 丢失 了 ， 因 为 它 只 是 瞬时 数据 ,在 活动 被 销毁 后 就 会 被 回收 。 而 


这 里 我 们 要 做 的 ， 就 是 在 数据 被 回收 之 前 ， 将 它 存储 到 文件 当中 。 修 改 MainActivity 中 的 代码 ， 


如 下 所 示 : 


public class MainActivity extends AppCompatActivity { 
private EditText edit; 


@Override 

protected void onCreate(Bundle savedInstanceState) { 
super.onCreate(savedInstanceState); 
setContentView(R.layout.activity main); 
edit = (EditText) findViewById(R.id.edit); 

} 


@Override 

protected void onDestroy() { 
super.onDestroy(); 
String inputText = edit.getText().toString(); 
save(inputText); 

} 


public void save(String inputText) { 
FileOutputStream out = null; 
BufferedWriter writer = null; 
try { 
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out = openFileOutput("data", Context.MODE PRIVATE); 
writer = new BufferedWriter(new OutputStreamWriter(out)); 
writer.write(inputText); 
} catch (IOException e) { 
e.printStackTrace(); 
} finally { 
try { 
if (writer != null) { 
writer.close(); 


} 
} catch (IOException e) { 


e.printStackTrace(); 
} 


} 


可 以 看 到 ,首先 我 们 在 onCreate() 方 法 中 获取 了 EditText 的 实例 ,然后 重 写 了 onDestroy() 
方法 ， 这 样 就 可 以 保证 在 活动 销毁 之 前 一 定 会 调用 这 个 方法 。 在 onDestroy() 方 法 中 我 们 获取 
了 EditText 中 输入 的 内 容 ， 并 调用 save() 方 法 把 输入 的 内 容 存 储 到 文件 中 ， 文 件 命名 为 data。 
save() 方 法 中 的 代码 和 之 前 的 示例 基本 相同 ， 这 里 就 不 再 做 解释 了 。 现 在 重新 运行 一 下 程序 ， 
并 在 EditText 中 输入 一 些 内 容 ， 如 图 6.1 所 示 。 


wa B11:20 
FilePersistenceTest 


Content| 


| O 口 


图 6.1 在 EditText 中 随意 输入 点 内 容 


然后 按 下 Back 键 关闭 程序 ， 这 时 我 们 输入 的 内 容 就 已 经 保存 到 文件 中 了 。 那 么 如 何 才能 证 
实数 据 确 实 已 经 保存 成 功 了 呢 ? 我 们 可 以 借助 Android Device Monitor 工具 来 查看 一 下 。 点 击 
Android Studio 导航 栏 中 的 Tools 一 Android， 会 看 到 如 图 6.2 所 示 的 工具 列表 。 
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Sync Project with Gradle Files 
恬 ! Android Device Monitor 
芭 AVD Manager 
.SDK Manager 
V Enable ADB Integration 
© Layout Inspector 
@ Theme Editor 
Q Google App Indexing Test 


图 6.2 ” Android 工具 列表 


点 击 Android Device Monitor 就 可 以 打开 Android Device Monitor 工具 了 ， 然 后 进入 File 
Explorer 标签 页 ,在 这 里 找到 /data/data/com.example.filepersistencetestfiles/ 目 录 ， 可 以 看 到 生成 了 
一 个 data 文件 ， 如 图 6.3 所 示 。( 注 : Android 7.0 系统 的 模拟 器 可 能 无 法 正常 查看 File Explorer 
中 的 内 容 ， 这 或 许 是 新 版 模拟 器 的 一 个 bug， 可 能 会 在 未 来 的 版 本 中 修复 。 如 果 你 遇 到 了 这 种 情 
况 ， 创 建 一 个 Android 6.0 系统 的 模拟 器 即 可 解决 。) 


总 Threads| 目 Heap| 目 Alocation Tr.. | 他 Network stat.| 南 Fle Explorer 3 | Emulator co-| 口 sstemmfor-| = 日 


二 SI 


Name Size Date Time er 
2016-04-16 09:46 
2016-04-16 03:40 
2016-04-16 07:51 
2016-04-24 11:18 
2016-04-24 11:18 
2016-04-24 11:18 
2016-04-24 11:24 

7 2016-04-24 11:24 -rw-rw---- 
2016-04-24 11:18 
2016-04-10 08:50 
2016-04-09 15:20 
2016-04-01 12:26 
2016-04-02 11:47 
2016-04-04 08:13 

? 5 2016-03-28 14:14 

» 启 com.exampleuilayouttest 2016-03-27 12:01 


图 6.3 生成 的 data 文件 
然后 点 击 图 6.4 中 左边 的 按钮 可 以 将 这 个 文件 导出 到 电脑 上 。 


阶 自 | 
图 6.4 导入 导出 按钮 


使 用 记事 本 打开 这 个 文件 ， 里面 的 内 容 如 图 6.5 所 示 。 


文件 (F) ”编辑 (E) 格式 (O) 可 看 (V) “帮助 (H) 
Content 


图 6.5” data 文件 中 的 内 容 
这 样 就 证 实 了 ， 在 EditText 中 输入 的 内 容 确实 已 经 成 功 保存 到 文件 中 了 。 
不 过 只 是 成 功 将 数据 保存 下 来 还 不 够 , 我 们 还 需要 想 办 法 在 下 次 启动 程序 的 时 候 让 这 些 数据 
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能 够 还 原 到 EditText 中 ， 因 此 接 下 来 我 们 就 要 学 习 一 下 如 何 从 文件 中 读 取 数 据 。 


6.2.2 ”从 文件 中 读 取 数据 


类 似 于 将 数据 存储 到 文件 中 ，Context 类 中 还 提供 了 一 个 openFileInput() 方 法 ， 用 于 从 
文件 中 读 取 数据 。 这 个 方法 要 比 openFiLe0utput () 简单 一 些 ， 它 只 接收 一 个 参数 ， 即 要 读 取 的 
文件 名 ， 然 后 系统 会 自动 到 /data/data/<package name>/files/ 目 录 下 去 加 载 这 个 文件 ， 并 返回 一 个 
FileInputStream 对 象 ， 得 到 了 这 个 对 象 之 后 再 通过 Java 流 的 方式 就 可 以 将 数据 读 取 出 来 了 。 

以 下 是 一 段 简单 的 代码 示例 ， 展 示 了 如 何 从 文件 中 读 取 文 本 数据 : 


public String Load() { 

FileInputStream in = null; 

BufferedReader reader = null; 

StringBuilder content = new StringBuilder(); 

try { 
in = openFileInput("data"); 
reader = new BufferedReader(new InputStreamReader (in)); 
String Line = ""; 
while ((line = reader.readLine()) != null) { 

content.append (line); 


} 
} catch (IOException e) { 
e.printStackTrace(); 
} finally { 
if (reader != null) { 
try { 
reader.close(); 
} catch (IOException e) { 
e.printStackTrace(); 
} 
} 
} 


return content.toString(); 
} 


在 这 段 代码 中 , 首先 通过 openFileInput() 方 法 获取 到 了 一 个 FileInputStreanm 对 象 , 然 
后 借助 它 又 构建 出 了 一 个 InputStreamReader 对 象 ， 接 着 再 使 用 InputStreamReader 构建 出 
一 个 BufferedReader 对 象 ， 这 样 我 们 就 可 以 通过 BufferedReader 进行 一 行 行 地 读 取 ， 把 文 
件 中 所 有 的 文本 内 容 全 部 读 取 出 来 ， 并 存放 在 一 个 StringBuilder 对 象 中 ,最 后 将 读 取 到 的 内 
容 返回 就 可 以 了 。 

了 解 了 从 文件 中 读 取 数据 的 方法 , 那么 我 们 就 来 继续 完善 上 一 小 节 中 的 例子 , 使 得 重新 启动 
程序 时 EditText 中 能 够 保留 我 们 上 次 输入 的 内 容 。 修 改 MainActivity 中 的 代码 ， 如 下 所 示 : 


public class MainActivity extends AppCompatActivity { 


private EditText edit; 
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@Override 
protected void onCreate(Bundle savedInstanceState) { 
super.onCreate(savedInstanceState); 
setContentView(R.layout.activity main); 
edit = (EditText) findViewById(R.id.edit); 
String inputText = Load() ; 
if (!TextUtils.isEmpty(inputText)) { 
edit.setText(inputText); 
edit.setSelection(inputText.Tlength()); 
Toast .makeText (this, "Restoring succeeded", Toast.LENGTH SHORT) .show() ; 


public String load() { 
FileInputStream in = null; 
BufferedReader reader = null; 
StringBuilder content = new StringBuilder(); 
try { 
in = openFileInput("data"); 
reader = new BufferedReader(new InputStreamReader (in)); 
String Line = ""; 
while ((Line = reader.readLine()) != nuLL) { 
content .append (line); 


} 
} catch (IOException e) { 
e.printStackTrace(); 
} finally { 
if (reader != nuLL) { 
try { 
reader.close(); 
} catch (IOException e) { 
e.printStackTrace(); 
} 
} 


} 
return content.toString(); 


} 

可 以 看 到 , 这 里 的 思路 非常 简单 , 在 onCreate() 方 法 中 调用 Load() 方 法 来 读 取 文件 中 存储 
的 文本 内 容 , 如 果 读 到 的 内 容 不 为 nutl ,就 调用 EditText 的 setText() 方 法 将 内 容 填 充 到 EditText 
里 , 并 调用 setSelection() 方 法 将 输入 光标 移动 到 文本 的 末尾 位 置 以 便于 继续 输入 ,然后 弹出 
一 句 还 原 成 功 的 提示 。1Load () 方 法 中 的 细节 我 们 在 前 面 已 经 讲 过 ， 这 里 就 不 再 歼 述 了 。 
注意 ， 上 述 代码 在 对 字符 串 进 行 非 空 判 断 的 时 候 使 用 了 TextUtils .isEmpty() 方 法 ， 这 是 
一 个 非常 好 用 的 方法 ， 它 可 以 一 次 性 进行 两 种 空 值 的 判断 。 当 传人 的 字符 串 等 于 null 或 者 等 于 
空 字 符 串 的 时 候 ， 这 个 方法 都 会 返回 true， 从 而 使 得 我 们 不 需要 先 单独 判断 这 两 种 空 值 再 使 用 
逻辑 运算 符 连 接 起 来 了 。 
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现在 重新 运行 一 下 程序 ， 刚 才 保 存 的 Content 字符 串 肯 定 会 被 填充 到 EditText 中 ， 然 后 编写 
一 点 其 他 的 内 容 ， 比 如 在 EditText 中 输入 Hello， 接 着 按 下 Back 键 退 出 程序 ， 再 重新 启动 程序 ， 
这 时 刚才 输入 的 内 容 并 不 会 丢失 ， 而 是 还 原 到 了 EditText 中 ， 如 图 6.6 所 示 。 


6.6 成功 还 原 保存 的 内 容 
这 样 我 们 就 已 经 把 文件 存储 方面 的 知识 学 习 完 了 , 其 实 所 用 到 的 核心 技术 就 是 Context 类 中 提 
供 的 openFileInput() 和 openFile0utput() 方 法 ,之 后 就 是 利用 Java 的 各 种 流 来 进行 读 写 操作 。 
不 过 正如 我 前 面 所 说 ,文件 存储 的 方式 并 不 适合 用 于 保存 一 些 较为 复杂 的 文本 数据 ， 因 此 ， 
下 面 我 们 就 来 学 习 一 下 Android 中 另 一 种 数据 持久 化 的 方式 ， 它 比 文件 存储 更 加 简单 易 用 ， 而 且 
可 以 很 方便 地 对 某 一 指定 的 数据 进行 读 写 操作 。 


6.3 SharedPreferences 存储 


不 同 于 文件 的 存储 方式 ，SharedPreferences 是 使 用 键 值 对 的 方式 来 存储 数据 的 。 也 就 是 说 ， 
当 保存 一 条 数据 的 时 候 , 需要 给 这 条 数据 提供 一 个 对 应 的 键 , 这 样 在 读 取 数据 的 时 候 就 可 以 通过 
这 个 键 把 相应 的 值 取出 来 。 而 且 SharedPreferences 还 支持 多 种 不 同 的 数据 类 型 存储 ， 如 果 存 储 的 
数据 类 型 是 整 型 , 那么 读 取出 来 的 数据 也 是 整 型 的 ; 如 果 存 储 的 数据 是 一 个 字符 串 ,， 那么 读 取 出 
来 的 数据 仍然 是 字符 串 。 

这 样 你 应 该 就 能 明显 地 感觉 到 , 使 用 SharedPreferences 来 进行 数据 持久 化 要 比 使 用 文件 方便 
很 多 ， 下 面 我 们 就 来 看 一 下 它 的 具体 用 法 吧 。 


6.3.1 将 数据 存储 到 SharedPreferences 中 
要 想 使 用 SharedPreferences 来 存储 数据 ,首先 需要 获取 到 SharedPreferences 对 象 .Android 
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中 主要 提供 了 3 种 方法 用 于 得 到 SharedPreferences 对 象 。 

1. Context 类 中 的 getSharedPreferences() 方 法 

此 方法 接收 两 个 参数 ， 第 一 个 参数 用 于 指定 SharedPreferences 文件 的 名 称 ， 如 果 指 定 的 文件 
不 存在 则 会 创建 一 个 ，SharedPreferences 文件 都 是 存放 在 /data/data/<package name>/shared_prefs/ 
目录 下 的 。 第 二 个 参数 用 于 指定 操作 模式 ， 目 前 只 有 MODE _PRIVATE 这 一 种 模式 可 选 ， 它 是 默 
认 的 操作 模式 ， 和 直接 传人 0 效果 是 相同 的 ， 表 示 只 有 当前 的 应 用 程序 才 可 以 对 这 个 
SharedPreferences 文件 进行 读 写 。 其 他 几 种 操作 模式 均 已 被 废弃 ，MODE WORLD READABLE 和 
MODE WORLD_WRITEABLE 这 两 种 模式 是 在 Android 4.2 版 本 中 被 废弃 的 ，MODE _ MULTI _ 
PROCESS 模式 是 在 Android 6.0 版 本 中 被 废弃 的 。 


2. Activity 类 中 的 getPreferences () 方 法 


这 个 方法 和 Context 中 的 getSharedPreferences() 方 法 很 相似 , 不 过 它 只 接收 一 个 操作 模 
式 参 数 ， 因 为 使 用 这 个 方法 时 会 自动 将 当前 活动 的 类 名 作为 SharedPreferences 的 文件 名 。 

3. PreferenceManager 类 中 的 getDefaultSharedPreferences() 方 法 

这 是 一 个 静态 方法 ， 它 接收 一 个 Context 参数 ， 并 自动 使 用 当前 应 用 程序 的 包 名 作为 前 级 
来 命名 SharedPreferences 文件 。 得 到 了 SharedPreferences 对 象 之 后 ， 就 可 以 开始 向 Shared- 
Preferences 文件 中 存储 数据 了 ， 主 要 可 以 分 为 3 步 实现 。 


(1) 调 用 SharedPreferences 对 象 的 edit () 方 法 来 获取 一 个 SharedPreferences .Editor 
对 象 。 

(2) 向 SharedPreferences.Editor 对 象 中 添加 数据 ， 比 如 添加 一 个 布尔 型 数据 就 使 用 
putBoolean() 方 法 ,添加 一 个 字符 串 则 使 用 putString () 方 法 ， 以 此 类 推 。 

(3) 调用 apply() 方 法 将 添加 的 数据 提交 ， 从 而 完成 数据 存储 操作 。 

不 知 不 觉 中 已 经 将 理论 知识 介绍 得 挺 多 了 ， 那 我 们 就 赶快 通过 一 个 例子 来 体验 一 下 
SharedPreferences 存储 的 用 法 吧 ,新 建 一 个 SharedPreferencesTest 项 目 , 然 后 修改 activity_main.xml 
中 的 代码 ， 如 下 所 示 : 

<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 

android:layout width="match parent" 


android:layout height="match parent" 
android:orientation="vertical" > 


<Button 
android:id="@+id/save data" 
android:layout width="match parent" 
android:layout height="wrap content" 
android:text="Save data" 
/> 


</LinearLayout> 
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这 里 我 们 不 做 任何 复杂 的 功能 ， 只 是 简单 地 放置 了 一 个 按钮 ， 用 于 将 一 些 数据 存储 到 
SharedPreferences 文件 当中 。 然 后 修改 MainActivity 中 的 代码 ， 如 下 所 示 : 


public class MainActivity extends AppCompatActivity { 


@Override 
protected void onCreate(Bundle savedInstanceState) { 
super.onCreate(savedInstanceState); 
setContentView(R.layout.activity main); 
Button saveData = (Button) findViewById(R.id.save data); 
saveData.setOnClickListener(new View.0nCLickListener() { 
@Override 
public void onClick(View v) { 
SharedPreferences.Editor editor = getSharedPreferences("data", 
MODE_ PRIVATE) .edit(); 
editor.putString("name", "Tom"); 
editor.putInt("age", 28); 
editor.putBoolean("married", false); 
editor.apply(); 


可 以 看 到 ， 这 里 首先 给 按钮 注册 了 一 个 点 击 事件 ， 然 后 在 点 击 事 件 中 通过 getShared- 
Preferences() 方 法 指定 SharedPreferences 的 文件 名 为 data， 并 得 到 了 SharedPreferences. 
Editor 对 象 。 接着 向 这 个 对 象 中 添加 了 3 条 不 同类 型 的 数据 , 最 后 调用 apply() 方 法 进行 提交 ， 
从 而 完成 了 数据 存储 的 操作 。 

很 简单 吧 ? 现在 就 可 以 运行 一 下 程序 了 ,进入 程序 的 主 界面 后 ， 点 击 一 下 Save data 按钮 。 

这 时 的 数据 应 该 已 经 保存 成 功 了 , 不 过 为 了 证 实 一 下 , 我 们 还 是 要 借助 File Explorer 来 进行 查看 。 
打开 Android Device Monitor， 并 点 击 File Explorer 标签 页 ， 然 后 进入 到 /data/data/com.example. 
sharedpreferencestest/shared_prefs/ 目 录 下 ， 可 以 看 到 生成 了 一 个 data.xml 文 件 ， 如 图 6.7 所 示 。 


总 Threads 目 Heap | 自 Allocation Tr... | 令 Network Stat. | 需 , File Explorer 3 | 图 Emulator Co... | 口 System Infor.. 9 日 
配 昌 | 一 | 十 了 
Name Size Date Time Permissions Info = 
BS com.example.filepersistencetest 2016-04-24 11:18 drwxr-x--x 
> com.example.fragmentbestpractice 2016-04-10 ”08:50 ”drwxr-x--x 
> BE com.example ,fragmenttest 2016-04-09 15:20 ”drwxr-x--x 
> EB com.example.listviewtest 2016-04-01 12:26 drwxr-x--x 
» EE com.example.recyclerviewtest 2016-04-02 11:47 drwxr-x--x 
4 EE com.example.sharedpreferencestest 2016-04-30 11:30 oC drwxr-x--x 
EE cache 2016-04-30 ”11:29 drwxrwx--x 
EE code_cache 2016-04-30 11:29 drwxrwx--x 
EE files 2016-04-30 ”11:29 drwx------ EE 
4 EE shared_prefs 2016-04-30 11:30 oC drwxrwx--x 本 
四 dataxml 186 2016-04-30 11:30 -rw-rw---- 
BS com.example.uibestpractice 2016-04-04 08:13 drwxr-x--x 
BS com.example.uicustomviews 2016-03-28 14:14 drwxr-x--x 
> BE com.example.uilayouttest 2016-03-27 12:01 drwxr-x--x 
> BE com.example.uisizetest 2016-04-04 05:12 drwxr-x--x 
> BE com.google.android.apps.maps 2016-04-30 08:10 ”drwxr-x--x 


图 6.7 生成 的 data.xml 文件 
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接 下 来 , 同样 是 点 击 导 出 按钮 将 这 个 文件 导出 到 电脑 上 ,并 用 记事 本 进行 查看 , 里 面 的 内 容 
如 图 6.8 所 示 。 


文件 (编辑 (6 格式 (O) 坦 看) 帮助 (H) 

《9xml version=’1.0’ encoding=’ utf-8” standalone=’ yes”93> « 
<map. 

《string name=“name”>Tom</string> 

boolean name= "married” value= false” /> 

《int name=”age” value="28” /> 


《Amap> 


6.8 data.xml 文件 中 的 内 容 


可 以 看 到 ， 我 们 刚刚 在 按钮 的 点 击 事件 中 添加 的 所 有 数据 都 已 经 成 功 保存 下 来 了 ， 并 且 
SharedPreferences 文件 是 使 用 XML 格式 来 对 数据 进行 管理 的 。 


那么 接 下 来 我 们 自然 要 看 一 看 ， 如 何 从 SharedPreferences 文件 中 去 读 取 这 些 数据 了 。 


6.3.2 ”从 SharedPreferences 中 读 取 数据 


你 应 该 已 经 感觉 到 了 , 使 用 SharedPreferences 来 存储 数据 是 非常 简单 的 , 不 过 下 面 还 有 更 好 
的 消息 ， 其 实 从 SharedPreferences 文件 中 读 取 数据 会 更 加 地 简单 。SharedPreferences 对 象 中 
提供 了 一 系列 的 get 方法 ， 用 于 对 存储 的 数据 进行 读 取 ， 每 种 get 方法 都 对 应 了 Shared- 
Preferences.Editor 中 的 一 种 put 方法 ,比如 读 取 一 个 布尔 型 数据 就 使 用 getBoolean() 方 法 ， 
读 取 一 个 字符 串 就 使 用 getString() 方 法 。 这 些 get 方法 都 接收 两 个 参数 ， 第 一 个 参数 是 键 ， 
传人 存储 数据 时 使 用 的 键 就 可 以 得 到 相应 的 值 了 ; 第 二 个 参数 是 默认 值 ， 即 表示 当 传 入 的 键 找 不 
到 对 应 的 值 时 会 以 什么 样 的 默认 值 进 行 返回 。 

我 们 还 是 通过 例子 来 实际 体验 一 下 吧 ， 仍然 是 在 SharedPreferencesTest 项 目的 基础 上 继续 开 
发 ， 修 改 activity_main.xml 中 的 代码 ， 如 下 所 示 : 

<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 

android:layout width="match parent" 


android:layout height="match parent" 
android:orientation="vertical" > 


<Button 
android:id="@+id/save_ data" 
android:layout width="match parent" 
android:layout height="wrap content" 
android:text="Save data" 
/> 
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<Button 
android:id="@+id/restore data" 
android:Tlayout width="match_parent" 
android:layout height="wrap_content" 
android:text="Restore data" 
/> 


</LinearLayout> 


这 里 增加 了 一 个 还 原 数据 的 按钮 , 我 们 希望 通过 点 击 这 个 按钮 来 从 SharedPreferences 文件 中 
读 取 数据 。 修 改 MainActivity 中 的 代码 ， 如 下 所 示 : 


public class MainActivity extends AppCompatActivity { 


@Override 

protected void onCreate(Bundle savedInstanceState) { 
super.onCreate(savedInstanceState); 
setContentView(R.layout.activity main); 


Button restoreData = (Button) findViewById(R.id.restore data); 
restoreData.setOnClickListener(new View.OnClickListener() { 
@Override 
public void onClick(View v) { 
SharedPreferences pref = getSharedPreferences("data", MODE_ PRIVATE); 
String name = pref.getString("name", ""); 
int age = pref.getInt("age", 0); 
boolean married = pref.getBoolean("married", false); 
Log.d("MainActivity", "name is " + name); 
Log.d("MainActivity", "age is " + age); 
Log.d("MainActivity", "married is " + married); 


}); 


可 以 看 到 ,我 们 在 还 原 数据 按钮 的 点 击 事件 中 首先 通过 getSharedPreferences() 方 法 得 到 
了 SharedPreferences 对 象 ， 然 后 分 别 调用 它 的 getString()、getInt() 和 getBoolean() 
方法 ,去 获取 前 面 所 存储 的 姓名 、 年 龄 和 是 否 已 婚 ， 如 果 没 有 找到 相应 的 值 ， 就 会 使 用 方法 中 传 
入 的 默认 值 来 代替 ， 最 后 通过 Log 将 这 些 值 打印 出 来 。 
现在 重新 运行 一 下 程序 ， 并 点 击 界 面 上 的 Restore data 按钮 ， 然 后 查看 logcat 中 的 打印 信息 ， 
如 图 6.9 所 示 。 


A 
verbose 加 c- ) 


com. example. sharedpreferencestest D/MainActivity: name is Tom 


com. example. sharedpreferencestest D/MainActivity: age is 28 


com. example. sharedpreferencestest D/MainActivity: married is false 


图 6.9 打印 data.xml 中 存储 的 内 容 
所 有 之 前 存储 的 数据 都 成 功 读 取 出 来 了 ! 通过 这 个 例子 ， 我 们 就 把 SharedPreferences 存储 
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的 知识 也 学 习 完 了 。 相 比 之 下 ，SharedPreferences 存储 确实 要 比 文本 存储 简单 方便 了 许多 , 应 用 
场景 也 多 了 不 少 , 比如 很 多 应 用 程序 中 的 偏好 设置 功能 其 实 都 使 用 到 了 SharedPreferences 技术 。 
那么 下 面 我 们 就 来 编写 一 个 记 住 密码 的 功能 ,相信 通过 这 个 例子 能 够 加 深 你 对 SharedPreferences 
的 理解 。 


6.3.3 ”实现 记 住 密码 功能 


既然 是 实现 记 住 密码 的 功能 , 那么 我 们 就 不 需要 从 头 去 写 了 , 因为 在 上 一 章 中 的 最 佳 实践 部 
分 已 经 编写 过 一 个 登录 界面 了 ， 有 可 以 重用 的 代码 为 什么 不 用 呢 ? 那 就 首先 打开 Broadcast- 
BestPractice 项 目 ， 来 编辑 一 下 登录 界面 的 布局 。 修 改 activity_login.xml 中 的 代码 ， 如 下 所 示 : 


<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:orientation="vertical" 
android:layout width="match parent" 
android:layout height="match parent"> 


<LinearLayout 
android:orientation="horizontal" 
android:Tlayout width="match_parent" 
android:layout height="wrap_content"> 
<CheckBox 
android:id="@+id/remember_pass" 
android:layout width="wrap_content" 
android:layout height="wrap_content" /> 


<TextView 
android:layout width="wrap_content" 
android:layout height="wrap_content" 
android:textSize="18sp" 
android:text="Remember password" /> 
</LinearLayout> 


<Button 
android:id="@+id/login" 
android:layout width="match parent" 
android:layout height="60dp" 
android:text="Login" /> 
</LinearLayout> 


这 里 使 用 到 了 一 个 新 控件 CheckBox。 这 是 一 个 复 选 框 控 件 ， 用 户 可 以 通过 点 击 的 方式 来 进 
行 选中 和 取消 ， 我 们 就 使 用 这 个 控件 来 表示 用 户 是 否 需 要 记 住 密码 。 
然后 修改 LoginActivity 中 的 代码 ， 如 下 所 示 : 


public class LoginActivity extends BaseActivity { 


private SharedPreferences pref; 


private SharedPreferences.Editor editor; 
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private EditText accountEdit; 
private EditText passwordEdit; 
private Button login; 

private CheckBox rememberPass 


@Override 
protected void onCreate(Bundle savedInstanceState) { 
super.onCreate(savedInstanceState); 
setContentView(R.layout.activity login); 
pref = PreferenceManager.getDefaultSharedPreferences(this); 
accountEdit = (EditText) findViewById(R.id.account); 
passwordEdit = (EditText) findViewById(R.id.password); 
rememberPass = (CheckBox) findViewById(R.id.remember_ pass); 
login = (Button) findViewById(R.id.1login); 
boolean isRemember = pref.getBoolean("remember password", false); 
if (isRemember) { 
// 将 账号 和 密码 都 设置 到 文本 框 中 
String account = pref.getString("account", ""); 
String password = pref.getString("password", ""); 
accountEdit.setText(account); 
passwordEdit.setText (password); 
rememberPass.setChecked (true); 
} 
login.setOnClickListener(new View.0nCLickListener() { 
@Override 
public void onClick(View v) { 
String account = accountEdit.getText().toString(); 
String password = passwordEdit.getText().toString(); 
// 如 果 账 号 是 admin 且 密 码 是 123456， 就 认为 登录 成 功 
if (account.equals("admin") && password.equals("123456")) { 
editor = pref.edit(); 
if (rememberPass.isChecked()) { // 检查 复 选 框 是 否 被 选中 
editor.putBoolean("remember password", true); 
editor.putString("account", account); 
editor.putString("password", password); 
} else { 
editor.clear(); 
} 
editor.apply(); 
Intent intent = new Intent(LoginActivity.this, MainActivity. 
class); 
startActivity(intent); 
finish(); 
} else { 
Toast.makeText(LoginActivity.this, "account or password is 
invalid", 
Toast .LENGTH_SHORT) .show() ; 
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} 


可 以 看 到 ， 这 里 首先 在 onCreate() 方 法 中 获取 到 了 SharedPreferences 对 象 ， 然 后 调用 
它 的 getBoolean() 方 法 去 获取 remember_password 这 个 键 对 应 的 值 。 一 开始 当然 不 存在 对 应 
的 值 了 ， 所 以 会 使 用 默认 值 fatse， 这 样 就 什么 都 不 会 发 生 。 接 着 在 登录 成 功 之 后 ， 会 调用 
CheckBox 的 isChecked () 方 法 来 检查 复 选 框 是 否 被 选中 ， 如 果 被 选中 了 ， 则 表示 用 户 想 要 记 住 
密码 ， 这 时 将 remember_password 设置 为 true， 然 后 把 account 和 password 对 应 的 值 都 存 
人 到 SharedPreferences 文件 当中 并 提交 。 如 果 没 有 被 选中 ， 就 简单 地 调用 一 下 clear() 方 法 , 将 
SharedPreferences 文件 中 的 数据 全 部 清除 掉 。 

当 用 户 选 中 了 记 住 密码 复 选 框 ， 并 成 功 登 录 一 次 之 后 ，remember_password 键 对 应 的 值 就 
是 true 了 ， 这 个 时 候 如 果 再 重新 启动 登录 界面 ， 就 会 从 SharedPreferences 文件 中 将 保存 的 账号 
和 密码 都 读 取出 来 ,并 填充 到 文本 输入 框 中 , 然后 把 记 住 密码 复 选 框 选 中 , 这 样 就 完成 记 住 密码 
的 功能 

现在 重新 运行 一 下 程序 ， 可 以 看 到 界面 上 多 出 了 一 个 记 住 密码 复 选 框 ， 如 图 6.10 所 示 。 

然后 账号 输入 admin， 密 码 输入 123456， 并 选中 记 住 密码 复 选 框 ， 点 击 登 录 ， 就 会 跳 转 到 
MainActivity。 接 着 在 MainActivity 中 发 出 一 条 强制 下 线 广播 ， 会 让 程序 重新 回 到 登录 界面 ， 此 
时 你 会 发 现 ， 账 号 密码 都 已 经 自动 填充 到 界面 上 了 ， 如 图 6.11 所 示 。 


i 1:51 Wi BB 1:54 
BroadcastBestPractice BroadcastBestPractice 


Account: | Account: admin 


图 6.10 ” 带 记 住 密码 复 选 框 的 登录 界面 图 6.11 实现 记 住 账号 密码 功能 


这 样 我 们 就 使 用 SharedPreferences 技术 将 记 住 密码 功能 成 功 实 现 了 ， 你 是 不 是 对 Shared- 
Preferences 理解 得 更 加 深刻 了 呢 ? 


Iml 
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不 过 需要 注意 , 这 里 实现 的 记 住 密码 功能 仍然 只 是 个 简单 的 示例 , 并 不 能 在 实际 的 项 目 中 直 
接 使 用 。 因 为 将 密码 以 明文 的 形式 存储 在 SharedPreferences 文件 中 是 非常 不 安全 的 , 很 容易 就 会 
被 别人 资 取 ， 因 此 在 正式 的 项 目 里 还 需要 结合 一 定 的 加 密 算 法 来 对 密码 进行 保护 才 行 。 

好 了 ， 关 于 SharedPreferences 的 内 容 就 讲 到 这 里 ， 接 下 来 我 们 要 学 习 一 下 本 章 的 重头 
戏 一 一 Android 中 的 数据 库 技 术 。 


6.4 _ SQLite 数据 库存 储 


在 刚 开始 接触 Android 的 时 候 ， 我 甚至 都 不 敢 相信 ，Android 系统 竟然 是 内 置 了 数据 库 的 ! 
好 吧 ， 是 我 太 孤 陋 寡 闻 了 。SQLite 是 一 款 轻 量 级 的 关系 型 数据 库 ， 它 的 运算 速度 非常 快 ， 占 用 资 
源 很 少 , 通常 只 需要 几 百 KB 的 内 存 就 足够 了 ， 因 而 特别 适合 在 移动 设备 上 使 用 。SQLite 不 仅 支 
持 标准 的 SQL 语法 ， 还 遵循 了 数据 库 的 ACID 事务 ， 所 以 只 要 你 以 前 使 用 过 其 他 的 关系 型 数据 
库 ， 就 可 以 很 快 地 上 手 SQLite。 而 SQLite 又 比 一 般 的 数据 库 要 简单 得 多 ， 它 甚至 不 用 设置 用 户 
名 和 密码 就 可 以 使 用 。Android 正 是 把 这 个 功能 极为 强大 的 数据 库 能 入 到 了 系统 当中 ， 使 得 本 地 
持久 化 的 功能 有 了 一 次 质 的 飞跃 。 


前 面 我 们 所 学 的 文件 存储 和 SharedPreferences 存 储 毕 竞 只 适用 于 保存 一 些 简单 的 数据 和 键 值 
对 ， 当 需要 存储 大 量 复杂 的 关系 型 数据 的 时 候 , 你 就 会 发 现 以 上 两 种 存储 方式 很 难 应 付 得 了 。 比 
如 我 们 手机 的 短信 程序 中 可 能 会 有 很 多 个 会 话 , 每 个 会 话 中 又 包含 了 很 多 条 信息 内 容 , 并 且 大 部 
分 会 话 还 可 能 各 自 对 应 了 电话 簿 中 的 某 个 联系 人 。 很 难 想象 如 何 用 文件 或 者 SharedPreferences 来 
存储 这 些 数 据 量 大 、 结 构 性 复杂 的 数据 吧 ? 但 是 使 用 数据 库 就 可 以 做 得 到 。 那么 我 们 就 赶快 来 看 
一 看 ，Android 中 的 SQLite 数据 库 到 底 是 如 何 使 用 的 。 


6.4.1 创建 数据 库 


Android 为 了 让 我 们 能 够 更 加 方便 地 管理 数据 库 ,专门 提供 了 一 个 SQLiteOpenHelper 帮助 类 ， 
借助 这 个 类 就 可 以 非常 简单 地 对 数据 库 进行 创建 和 升级 。 既然 有 好 东西 可 以 直接 使 用 , 那 我 们 自 
然 要 尝试 一 下 了 ， 下 面 我 就 对 SQLiteOpenHelper 的 基本 用 法 进行 介绍 。 

首先 你 要 知道 SQLiteOpenHelper 是 一 个 抽象 类 ， 这 意味 着 如 果 我 们 想 要 使 用 它 的 话 ， 就 需 
要 创建 一 个 自己 的 帮助 类 去 继承 它 。SQLiteOpenHelper 中 有 两 个 抽象 方法 ， 分 别 是 onCreate() 
和 onuUpgrade() ， 我 们 必须 在 自己 的 帮助 类 里 面 重 写 这 两 个 方法 ， 然 后 分 别 在 这 两 个 方法 中 去 
实现 创建 、 升 级 数据 库 的 逻辑 。 

SQLiteOpenHelper 中 还 有 两 个 非常 重要 的 实例 方法 : getReadableDatabase() 和 get- 
WritableDatabase()。 这 两 个 方法 都 可 以 创建 或 打开 一 个 现 有 的 数据 库 ( 如果 数据 库 已 存在 则 
直接 打开 ,和 否则 创建 一 个 新 的 数据 库 ), 并 返回 一 个 可 对 数据 库 进行 读 写 操作 的 对 象 。 不同 的 是 ， 
当 数 据 库 不 可 写 入 的 时 候 ( 如 磁盘 空间 已 满 )，getReadableDatabase() 方 法 返回 的 对 象 将 以 只 
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读 的 方式 去 打开 数据 库 ， 而 getwritableDatabase() 方 法 则 将 出 现 异常 。 

SQLiteOpenHelper 中 有 两 个 构造 方法 可 供 重 写 ， 一般 使 用 参数 少 一 点 的 那个 构造 方法 即 可 。 
这 个 构造 方法 中 接收 4 个 参数 ， 第 一 个 参数 是 Context， 这 个 没什么 好 说 的 ， 必 须要 有 它 才 能 对 
数据 库 进行 操作 。 第 二 个 参数 是 数据 库 名 , 创建 数据 库 时 使 用 的 就 是 这 里 指定 的 名 称 。 第 三 个 参 
数 允 许 我 们 在 查询 数据 的 时 候 返 回 一 个 自 定义 的 Cursor， 一 般 都 是 传人 nuLL。 第 四 个 参数 表示 
当前 数据 库 的 版 本 号 ， 可 用 于 对 数据 库 进 行 升级 操作 。 构 建 出 SQLiteOpenHelper 的 实例 之 后 ， 
再 调用 它 的 getReadableDatabase() 或 getWritabLeDatabase() 方 法 就 能 够 创建 数据 库 了 ， 
数据 库 文 件 会 存放 在 /data/data/<package name>/databases/ 目 录 下 。 此 时 , 重 写 的 onCreate( ) 方 法 
也 会 得 到 执行 ， 所 以 通常 会 在 这 里 去 处 理 一 些 创建 表 的 逻辑 。 

接 下 来 还 是 让 我 们 通过 例子 的 方式 来 更 加 直观 地 体会 SQLiteOpenHelper 的 用 法 吧 ， 首 先 新 
建 一 个 DatabaseTest 项 目 。 

这 里 我 们 希望 创建 一 个 名 为 BookStore.db 的 数据 库 , 然后 在 这 个 数据 库 中 新 建 一 张 Book 表 ， 
表 中 有 id ( 主键 )、 作 者 、 价 格 、 页 数 和 书 名 等 列 。 创 建 数据 库 表 当然 还 是 需要 用 建 表 语句 的 ， 
这 里 也 是 要 考验 一 下 你 的 SQL 基本 功 了 ，Book 表 的 建 表 语句 如 下 所 示 : 

create table Book ( 

id integer primary key autoincrement, 
author text, 

price real, 

pages integer, 

name text) 

只 要 你 对 SQL 方面 的 知识 稍微 有 一些 了 解 , 上 面 的 建 表 语句 对 你 来 说 应 该 都 不 难 吧 。 SQLite 
不 像 其 他 的 数据 库 拥有 众多 繁杂 的 数据 类 型 ， 它 的 数据 类 型 很 简单 ，integer 表示 整 型 ，real 
表示 浮 点 型 ，text 表示 文本 类 型 ，blob 表示 二 进 制 类 型 。 另 外 ， 上 述 建 表 语 句 中 我 们 还 使 用 了 
primary key 将 id 列 设 为 主键 ， 并 用 autoincrement 关键 字 表示 id 列 是 自 增长 的 。 

然后 需要 在 代码 中 去 执行 这 条 SQL 语句 ， 才 能 完成 创建 表 的 操作 。 新 建 MyDatabaseHelper 
类 继承 自 SQLiteOpenHelper， 代 码 如 下 所 示 


public class MyDatabaseHeLper extends SQLite0penHeLper { 


public static final String CREATE BOOK = "create table Book (" 
+ "id integer primary key autoincrement, " 
+ "author text, " 
+ "price real, " 
+ "pages integer, " 
+ "name text)",; 


private Context mContext ; 


public MyDatabaseHeLper(Context context, String name, 
SQLiteDatabase,CursorFactory factory, int version) { 
super(context, name, factory, version); 
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mContext = context; 


} 


GOverride 
public void onCreate(SQLiteDatabase db) { 

db.execSQL(CREATE BOOK); 

Toast.makeText (mContext, "Create succeeded", Toast.LENGTH SHORT).show(); 
} 


GOverride 
public void onUpgrade(SQLiteDatabase db，int oldVersion, int newVersion) { 
} 


} 

可 以 看 到 ， 我 们 把 建 表 语 名 定义 成 了 一 个 字符 串 常量 ， 然 后 在 onCreate() 方 法 中 又 调用 了 
SQLiteDatabase 的 execSQL( ) 方 法 去 执行 这 条 建 表 语句 ， 并 弹出 一 个 Toast 提示 创建 成 功 ， 这 样 
就 可 以 保证 在 数据 库 创建 完成 的 同时 还 能 成 功 创建 Book 表 。 

现在 修改 activity_main.xml 中 的 代码 ， 如 下 所 示 : 


<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:orientation="vertical" 
android:layout width="match parent" 
android:layout height="match parent" 


> 
<Button 
android:id="@+id/create database" 
android:layout width="match parent" 
android:layout height="wrap_ content" 
android:text="Create database" 
/> 
</LinearLayout> 
布局 文件 很 简单 , 就 是 加 入 了 一 个 按钮 , 用 于 创建 数据 库 。 最 后 修改 MainActivity 中 的 代码 ， 
如 下 所 示 : 


public class MainActivity extends AppCompatActivity { 
private MyDatabaseHelper dbHeLper; 


GOverride 
protected void onCreate(Bundle savedInstanceState) { 
super.onCreate(savedInstanceState); 
setContentView(R.layout.activity main); 
dbHelper = new MyDatabaseHelper(this, "BookStore.db", null, 1); 
Button createDatabase = (Button) findViewById(R,id.create database); 
createDatabase.setOnClickListener(new View.0nCLickListener() { 
@Override 
public void onClick(View v) { 
dbHelper.getWritableDatabase(); 
} 
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}); 


} 


这 里 我 们 在 onCreate() 方 法 中 构建 了 一 个 MyDatabaseHelper 对 象 , 并 日 通过 构造 函数 的 
参数 将 数据 库 名 指定 为 BookStore.db ， 版 本 号 指定 为 1， 然 后 在 Create database 按钮 的 点 击 事件 
里 调用 了 getWritableDatabase() 方 法 。 这 样 当 第 一 次 点 击 Create database 按钮 时 ， 就 会 检测 到 
当前 程序 中 并 没有 BookStore.db 这 个 数据 库 ， 于 是 会 创建 该 数据 库 并 调用 MyDatabaseHelper 中 的 
onCreate () 方 法 ， 这 样 Book 表 也 就 得 到 了 创建 ， 然 后 会 弹出 一 个 Toast 提示 创建 成 功 。 再 次 点 
击 Create database 按钮 时 ， 会 发 现 此 时 已 经 存在 BookStore.db 数据 库 了 ， 因 此 不 会 再 创建 一 次 。 

现在 就 可 以 运行 一 下 代码 了 ， 在 程序 主 界面 点 击 Create database 按钮 ， 结 果 如 图 6.12 所 示 。 


G2:38 


DatabaseTest 


CREATE DATABASE 


Create succeeded 


本 O 〇 口 
图 6.12 ”创建 数据 库 成 功 


此 时 BookStore.db 数据 库 和 Book 表 应 该 都 已 经 创建 成 功 了 ， 因 为 当 你 再 次 点 击 Create 
database 按钮 时 ， 不 会 再 有 Toast 弹出 。 可 是 又 回 到 了 之 前 的 那个 老 问题 ， 怎 样 才 能 证 实 它们 的 
确 创建 成 功 了 ? 如 果 还 是 使 用 File Explorer， 那 么 最 多 你 只 能 看 到 databases 目录 下 出 现 了 一 个 
BookStore.db 文件 , Book 表 是 无 法 通过 File Explorer 看 到 的 。 因此 这 次 我 们 准备 换 一 种 查看 方式 ， 
使 用 adb shell 来 对 数据 库 和 表 的 创建 情况 进行 检查 。 

adb 是 Android SDK 中 自 带 的 一 个 调试 工具 ， 使 用 这 个 工具 可 以 直接 对 连接 在 电脑 上 的 手机 
或 模拟 器 进行 调试 操作 。 它 存放 在 sdk 的 platform-tools 目录 下 ， 如果 想 要 在 命令 行 中 使 用 这 个 工 
具 ， 就 需要 先 把 它 的 路 径 配 置 到 环境 变量 里 。 

如 果 你 使 用 的 是 Windows 系统 ， 可 以 右 击 计 算 机 一 属性 一 高 级 系统 设置 一 环境 变量 ， 然 后 
在 系统 变量 里 找到 Path 并 点 击 编辑 ， 将 platform-tools 目录 配置 进去 ， 如 图 6.13 所 示 。 
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由 Rss 全 。 
编辑 系统 变量 名 
变量 名 Path 
变量 值 ) ta\Local\Android\sdk\platform-tools 
确定 
系统 变量 G) 
变量 值 
0s Windows_HT 
Path C:\Windows\system32;C: \Windows; 
PATHEXT COM:;. EXE;. BAT; .CNWD;. VBS;. YBE 
PRNCRSSNR AR ANNR4 
[局 建 o.… ] [编辑 上 ] [出 除 C) ] 
确定 ] [ 取消 ] 
L 


图 6.13 Windows 下 配置 环境 变量 
如 果 你 使 用 的 是 Linux 或 Mac 系统 ， 可 以 在 home 路 径 下 编辑 .bash 文件 ， 将 platform-tools 
目录 配置 进去 即 可 ， 如 图 6.14 所 示 。 


Terminal 


/android-sdk-linux/platform-tools 


图 6.14 Linux 或 Mac 下 配置 环境 变 


配置 好 了 环境 变量 之 后 ， 就 可 以 使 用 adb 工具 
人 到 设备 的 控制 台 ， 如 图 6.15 所 示 。 


了 。 打 开 命 令 行 界 面 ， 输 入 adb sheLL， 就 会 


图 6.15 进入 设备 的 控制 台 


E 员 的 意 
EH 意思 ， 


其 中 ，# 符 号 是 超级 管理 也 就 是 说 现在 你 可 以 访问 模拟 器 中 的 一 切 数据 。 如 果 你 
的 命令 行 上 显示 的 是 $ 符 号 , 那么 就 表示 你 现在 是 普遍 管理 
才能 执行 下 面 的 操作 。 


人 4 人 外 
佳 征 


E 员 , 需 输入 su 命令 切换 成 超级 管理 员 ， 


接 下 来 使 用 cd 命令 进入 到 /data/data/com.example.databasetest/databases/ 目 录 下 ， 并 使 用 ls 
命令 查看 到 该 目录 里 的 文件 ， 如 图 6.16 所 示 。 


EC\Windows\system32\cmd.exe adb shell 


图 6.16 ”查看 数据 库 文件 
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这 个 目录 下 出 现 了 两 个 数据 库 文 件 ,一 个 正 是 我 们 创建 的 BookStore.db , 而 另 一 个 BookStore. 
db-journal 则 是 为 了 证 数据 库 能 够 支持 事务 而 产生 的 临时 日 志文 件 ， 通 常情 况 下 这 个 文件 的 大 小 
都 是 0 字 节 。 

接 下 来 我 们 就 要 借助 sqlite 命令 来 打开 数据 库 了 ， 只 需要 键入 sqlite3 ， 后 面 加 上 数据 库 名 
即 可 ， 如 图 6.17 所 示 。 


和 
画 C\Windows\system32\cmd.exe - adb shell 
lite3 Boo pb 


图 6.17 打开 BookStore.db 数据 库 


这 时 就 已 经 打开 了 BookStore.db 数据 库 , 现在 就 可 以 对 这 个 数据 库 中 的 表 进 行 管理 了 。 首先 
来 看 一 下 目前 数据 库 中 有 哪些 表 ， 键 入 .tabte 命令 ， 如 图 6.18 所 示 。 


图 6.18 查看 表 


可 以 看 到 , 此 时 数据 库 中 有 两 张 表 ,android_metadata 表 是 每 个 数据 库 中 都 会 自动 生成 的 ， 
不 用 管 它 ， 而 另外 一 张 Book 表 就 是 我 们 在 MyDatabaseHelper 中 创建 的 了 。 这 里 还 可 以 通 
过 .schema 命令 来 查看 它们 的 建 表 语句 ， 如 图 6.19 所 示 。 


图 6.19 查看 建 表 语 句 


由 此 证 明 ，BookStore.db 数据 库 和 Book 表 确 实 已 经 创建 成 功 了 。 之 后 键 人 .exit 或 .quit 
命令 可 以 退出 数据 库 的 编辑 ， 再 键入 exit 命令 就 可 以 退出 设备 控制 台 了 。 
6.4.2 ”升级 数据 库 


如 果 你 足够 细心 , 一 定 会 发 现 MyDatabaseHelper 中 还 有 一 个 空 方法 呢 ! 没 错 , onUpgrade() 
方法 是 用 于 对 数据 库 进 行 升级 的 , 它 在 整个 数据 库 的 管理 工作 当中 起 着 非常 重要 的 作用 , 可 千 万 
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不 能 忽视 它 哟 。 

目前 DatabaseTest 项 目 中 已 经 有 一 张 Book 表 用 于 存放 书 的 各 种 详细 数据 ， 如 果 我 们 想 再 添 
加 一 张 Category 表 用 于 记录 图 书 的 分 类 ， 该 怎么 做 呢 ? 

比如 Category 表 中 有 id ( 主键 )、 分 类 名 和 分 类 代码 这 几 个 列 ， 那么 建 表 语 句 就 可 以 写成 : 


create table Category ( 
id integer primary key autoincrement, 
category name text, 
category code integer) 


接 下 来 我 们 将 这 条 建 表 语 句 添加 到 MyDatabaseHelper 中 ， 代 码 如 下 所 示 : 


public class MyDatabaseHelper extends SQLiteOpenHelper { 


public static final String CREATE BOOK = "create table Book (" 
+ "id integer primary key autoincrement, " 

"author text, " 

"price real, " 

"pages integer, 

"name text)"; 


+ 十 十 十 


public static final String CREATE CATEGORY = "create table Category (" 
+ "id integer primary key autoincrement, " 
+ "category_name text, " 
+ "category code integer)"; 


private Context mContext; 


public MyDatabaseHelper(Context context, String name, 
SQLiteDatabase.CursorFactory factory, int version) { 
super(context, name, factory, version); 
mContext = context; 


} 


GOverride 
public void onCreate(SQLiteDatabase db) { 

db.execSQL(CREATE BOOK); 

db.execSQL(CREATE CATEGORY); 

Toast.makeText (mContext, "Create succeeded", Toast.LENGTH SHORT).show(); 
} 


GOverride 
public void onUpgrade(SQLiteDatabase db，int oldVersion, int newVersion) { 
} 


} 


看 上 去 好 像 都 挺 对 的 吧 ? 现在 我 们 重新 运行 一 下 程序 ， 并 点 击 Create database 按钮 ， 吓 ? 竟 
然 没 有 弹出 创建 成 功 的 提示 。 当 然 ， 你 也 可 以 通过 adb 工具 到 数据 库 中 再 去 检查 一 下 ， 这 样 你 会 
更 加 地 确认 Category 表 没 有 创建 成 功 ! 
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其 实 没有 创建 成 功 的 原因 不 难 思考 ,因为 此 时 BookStore.db 数据 库 已 经 存在 了 , 之 后 不 管 我 
们 怎样 点 击 Create database 按钮 ，MyDatabaseHelper 中 的 onCreate() 方 法 都 不 会 再 次 执行 ， 
此 新 添加 的 表 也 就 无 法 得 到 创建 了 。 

解决 这 个 问题 的 办 法 也 相当 简单 , 只 需要 先 将 程序 伸 载 掉 , 然后 重新 运行 , 这 时 BookStore.db 
数据 库 已 经 不 存在 了 ， 如 果 再 点 击 Create database 按钮 ，MyDatabaseHelper 中 的 onCreate() 方 
法 就 会 执行 ， 这 时 Category 表 就 可 以 创建 成 功 了 。 

不 过 , 通过 仓 载 程序 的 方式 来 新 增 一 张 表 毫 无 疑问 是 很 极端 的 做 法 ,其 实 我 们 只 需要 巧妙 地 
运用 SQLiteOpenHelper 的 升级 功能 就 可 以 很 轻松 地 解决 这 个 问题 。 修 改 MyDatabaseHelper 中 的 
代码 ， 如 下 所 示 : 


public class MyDatabaseHeLper extends SQLiteOpenHelper { 


@Override 

public void onUpgrade(SQLiteDatabase db, int oldVersion, int newVersion) { 
db .execSQL("drop table if exists Book"); 
db.execSQL("drop table if exists Category"); 
onCreate(db); 


} 

可 以 看 到 , 我 们 在 onUpgrade() 方 法 中 执行 了 两 条 DROP 语句 ， 如 果 发 现 数据 库 中 已 经 存在 
Book 表 或 Category 表 了 ,就 将 这 两 张 表 删 除 掉 , 然后 再 调用 onCreate ( ) 方 法 重新 创建 。 这 里 先 
将 已 经 存在 的 表 删 除 掉 ， 因 为 如 果 在 创建 表 时 发 现 这 张 表 已 经 存在 了 ， 就 会 直接 报错 。 

接 下 来 的 问题 就 是 如 何 让 onUpgrade ( ) 方 法 能 够 执行 了 , 还 记得 SQLiteOpenHelper 的 构造 方 
法 里 接收 的 第 四 个 参数 吗 ?” 它 表 示 当 前 数据 库 的 版 本 号 ， 之 前 我 们 传人 的 是 1， 现 在 只 要 传人 一 
个 比 1 大 的 数 , 就 可 以 让 onUpgrade() 方 法 得 到 执行 了 。 修改 MainActivity 中 的 代码 ， 如 下 所 示 : 


public class MainActivity extends AppCompatActivity { 


private MyDatabaseHelper dbHelper; 


@Override 
protected void onCreate(Bundle savedInstanceState) { 
super.onCreate(savedInstanceState); 
setContentView(R.layout.activity main); 
dbHelper = new MyDatabaseHelper(this, "BookStore.db", null, 2); 
Button createDatabase = (Button) findViewById(R.id.create database); 
createDatabase.setOnClickListener(new View.OnClickListener() { 
@Override 
public void onClick(View v) { 
dbHelper.getWritableDatabase(); 
} 
}); 
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} 

这 里 将 数据 库 版 本 号 指定 为 2， 表 示 我 们 对 数据 库 进 行 升级 了 。 现 在 重新 运行 程序 ， 并 点 击 
Create database 按钮 ， 这 时 就 会 再 次 弹出 创建 成 功 的 提示 。 为 了 验证 一 下 Category 表 是 不 是 已 经 
创建 成 功 了 ， 我 们 在 adb shell 中 打开 BookStore.db 数据 库 ， 然 后 键入 ,table 命令， 结果 如 图 
6.20 所 示 。 


图 6.20 ”查看 新 增 表 
接着 键入 .schema 命令 查看 一 下 建 表 语句 ， 结 果 如 图 6.21 所 示 。 


图 6.21 查看 新 增 建 表 语 句 


由 此 可 以 看 出 ，Category 表 已 经 创建 成 功 了 ， 同 时 也 说 明 我 们 的 升级 功能 的 确 起 到 了 作用 。 


6.4.3 ”添加 数据 


现在 你 已 经 掌握 了 创建 和 升级 数据 库 的 方法 , 接 下 来 就 该 学 习 一 下 如 何 对 表 中 的 数据 进行 操 
作 了 。 其 实 我 们 可 以 对 数据 进行 的 操作 无 非 有 4 种 ， 即 CRUD。 其 中 C 代表 添加 (Create )，R 代 
表 查 询 (Retrieve )，U 代表 更 新 (Update )，D 代表 删除 ( Delete )。 每 一 种 操作 又 各 自 对 应 了 一 
种 SQL 命令 ， 如 果 你 比较 熟悉 SQL 语言 的 话 ， 一 定 会 知道 添加 数据 时 使 用 insert ， 查 询 数据 
时 使 用 seLect ， 更 新 数据 时 使 用 update， 删 除数 据 时 使 用 deLete。 但 是 开发 者 的 水 平 总 会 是 
参差 不 齐 的 , 未 必 每 一 个 人 都 能 非常 熟悉 地 使 用 SQL 语言 , 因此 Android 也 提供 了 一 系列 的 辅助 
性 方法 ， 使 得 在 Android 中 即使 不 去 编写 SQL 语句 ， 也 能 轻松 完成 所 有 的 CRUD 操作 。 

前 面 我 们 已 经 知道 ， 调 用 SQLiteOpenHelper 的 getReadabtLeDatabase() 或 getWritabte- 
Database() 方 法 是 可 以 用 于 创建 和 升级 数据 库 的 ， 不仅 如 此 ， 这 两 个 方法 还 都 会 返回 一 个 
SQLiteDatabase 对 象 ， 借 助 这 个 对 象 就 可 以 对 数据 进行 CRUD 操作 了 。 

那么 下 面 我 们 首先 学 习 一 下 如 何 向 数据 库 的 表 中 添加 数据 吧 。SQLiteDatabase 中 提供 了 一 
个 insert () 方 法 ， 这 个 方法 就 是 专门 用 于 添加 数据 的 。 它 接收 3 个 参数 ， 第 一 个 参数 是 表 名 ， 
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我 们 希望 向 哪 张 表 里 添 加 数据 , 这 里 就 传人 该 表 的 名 字 。 第 二 个 参数 用 于 在 未 指定 添加 数据 的 情 
况 下 给 某 些 可 为 空 的 列 自动 赋值 NULL, 一 般 我 们 用 不 到 这 个 功能 , 直接 传人 null 即 可 。 第 三 个 


参数 是 一 个 


中 添加 数据 


ContentValues 对 象 ， 它 提供 了 一 系列 的 put () 方 法 重 载 ， 用 于 向 ContentValues 
， 只 需要 将 表 中 的 每 个 列 名 以 及 相应 的 待 添 加 数据 传人 即 可 。 


介绍 完 


了 基本 用 法 , 接 下 来 还 是 让 我 们 通过 例子 的 方式 来 亲身 体验 一 下 如 何 添 加 数据 吧 。 修 


改 activity_main.xml 中 的 代码 ， 如 下 所 示 : 


<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:orientation="vertical" 
android:layout width="match parent" 
android:layout height="match parent" 


> 

<Button 
android:id="@+id/add_data" 
android:layout width="match_ parent" 
android:layout height="wrap_content" 
android: text="Add data" 
/> 

</LinearLayout> 


可 以 看 到 , 我 们 在 布局 文件 中 叉 新 增 了 一 个 按钮 , 稍 后 就 会 在 这 个 按钮 的 点 击 事件 里 编写 添 
加 数据 的 逻辑 。 接 着 修改 MainActivity 中 的 代码 ， 如 下 所 示 : 


public 


class MainActivity extends AppCompatActivity { 


private MyDatabaseHelper dbHeLper; 


@Override 
protected void onCreate(Bundle savedInstanceState) { 


super.onCreate(savedInstanceState);, 
setContentView(R.layout.activity main); 
dbHelper = new MyDatabaseHelper(this, "BookStore.db", null, 2); 


Button addData = (Button) findViewById(R.id.add data); 
addData.setOnClickListener(new View.0nCLickListener() { 
@Override 
public void onClick(View v) { 
SQLiteDatabase db = dbHelper.getWwritableDatabase(); 
ContentValues values = new ContentValues(); 
// 开始 组 装 第 一 条 数据 
values.put("name", "The Da Vinci Code"); 
values.put("author", "Dan Brown"); 
values.put("pages", 454); 
values.put("price", 16.96); 
db.insert("Book"，null，values); // 插入 第 一 条 数据 
values.clear(); 
// 开始 组 装 第 二 条 数据 
values.put("name", "The Lost Symbol"); 
values.put("author", "Dan Brown"); 
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values.put("pages", 510); 
values.put("price", 19.95); 
db.insert("Book"，null，values); // 插入 第 二 条 数据 


}); 


在 添加 数据 按钮 的 点 击 事件 里 面 ， 我们 先 获 取 到 了 SQLiteDatabase 对 象 ， 然 后 使 用 
ContentValues 来 对 要 添加 的 数据 进行 组 装 。 如 果 你 比较 细心 的 话 应 该 会 发 现 ， 这 里 只 对 Book 
表 里 其 中 四 列 的 数据 进行 了 组 装 ，id 那 一 列 并 没 给 它 赋 值 。 这 是 因为 在 前 面 创建 表 的 时 候 , 我 们 
就 将 id 列 设 置 为 自 增 长 了 ， 它 的 值 会 在 入 库 的 时 候 自 动 生 成 ， 所 以 不 需要 手动 给 它 赋 值 了 。 接 
下 来 调用 了 insert() 方 法 将 数据 添加 到 表 当 中 ， 注意 这 里 我 们 实际 上 添加 了 两 条 数据 ， 上 述 代 
码 中 使 用 ContentValues 分 别 组 装 了 两 次 不 同 的 内 容 ， 并 调用 了 两 次 insert() 方 法 。 

好 了 ， 现 在 可 以 重新 运行 一 下 程序 了 ， 界 面 如 图 6.22 所 示 。 


i GB 12:36 


DatabaseTest 


CREATE DATABASE 


ADD DATA 


图 6.22 ”加 入 添加 数据 按钮 


点 击 一 下 Add data 按钮 ， 此 时 两 条 数据 应 该 都 已 经 添加 成 功 了 , 不 过 为 了 证 实 一 下 , 我 们 还 是 
打开 BookStore.db 数据 库 瞧 一 瞧 。 输 入 SQL 查询 语句 seLect * from Book; ， 结 果 如 图 6.23 所 示 。 


图 6.23 ”查看 添加 的 数据 


由 此 可 以 看 出 ， 我 们 刚刚 组 装 的 两 条 数据 都 已 经 准确 无 误 地 添加 到 Book 表 中 了 。 
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6.4.4 ”更 新 数据 


学 习 完 了 如 何 向 表 中 添加 数据 ， 接 下 来 我 们 看 看 怎样 才能 修改 表 中 已 有 的 数据 。SQLite- 
Database 中 也 提供 了 一 个 非常 好 用 的 update () 方 法 ， 用 于 对 数据 进行 更 新 ， 这 个 方法 接收 4 
个 参数 ， 第 一 个 参数 和 insert () 方 法 一 样 ， 也 是 表 名 ， 在 这 里 指定 去 更 新 哪 张 表 里 的 数据 。 第 
二 个 参数 是 ContentValues 对 象 ， 要 把 更 新 数据 在 这 里 组 装 进去 。 第 三 、 第 四 个 参数 用 于 约束 
更 新 某 一 行 或 某 几 行 中 的 数据 ， 不 指定 的 话 默认 就 是 更 新 所 有 行 。 

那么 接 下 来 我 们 仍然 是 在 DatabaseTest 项 目的 基础 上 修改 ， 看 一 下 更 新 数据 的 具体 用 法 。 比 
如 说 刚才 添加 到 数据 库 里 的 第 一 本 书 ,， 由 于 过 了 畅销 季 ， 卖 得 不 是 很 火 了 , 现在 需要 通过 降低 价 
格 的 方式 来 吸引 更 多 的 顾客 ， 我 们 应 该 怎么 操作 呢 ? 首先 修改 activity_ main.xml 中 的 代码 ， 如 下 
所 示 : 


<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:orientation="vertical" 
android:layout width="match parent" 
android:layout height="match parent" 


> 

<Button 
android:id="@+id/update_ data" 
android:Tlayout width="match_parent" 
android:layout height="wrap_content" 
android: text="Update data" 
/> 

</LinearLayout> 


布局 文件 中 的 代码 已 经 非常 简单 了 ， 就 是 添加 了 一 个 用 于 更 新 数据 的 按钮 。 然 后 修改 
MainActivity 中 的 代码 ， 如 下 所 示 : 


public class MainActivity extends AppCompatActivity { 
private MyDatabaseHelper dbHelper; 


@Override 

protected void onCreate(Bundle savedInstanceState) { 
super.onCreate(savedInstanceState), 
setContentView(R.layout.activity main); 
dbHelper = new MyDatabaseHelper(this, "BookStore.db", null, 2); 


Button updateData = (Button) findViewById(R.id.update data); 
updateData.setOnClickListener(new View.OnClickListener() { 
@Override 
public void onClick(View v) { 
SQLiteDatabase db = dbHelper.getWwritableDatabase(); 
ContentValues values = new ContentValues(); 
values.put("price", 10.99); 
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db.update("Book", values, "name = ?", new String[] { "The Da Vinci 
Code" }); 


}); 


这 里 在 更 新 数据 按钮 的 点 击 事件 里 面 构建 了 一 个 ContentValues 对 象 ， 并 且 只 给 它 指定 了 
一 组 数据 ， 说 明 我 们 只 是 想 把 价格 这 一 列 的 数据 更 新 成 10.99。 然 后 调用 了 SQLiteDatabase 的 
update() 方 法 去 执行 具体 的 更 新 操作 ， 可 以 看 到 ， 这 里 使 用 了 第 三 、 第 四 个 参数 来 指定 具体 更 
新 哪 几 行 。 第 三 个 参数 对 应 的 是 SQL 语句 的 where 部 分 ， 表 示 更 新 所 有 name 等 于 ?的 行 ， 而 ? 
是 一 个 占 位 符 , 可 以 通过 第 四 个 参数 提供 的 一 个 字符 串 数 组 为 第 三 个 参数 中 的 每 个 占 位 符 指定 相 
应 的 内 容 。 因 此 上 述 代码 想 表 达 的 意图 是 将 名 字 是 The Da Vinci Code 的 这 本 书 的 价格 改 成 10.99。 

现在 重新 运行 一 下 程序 ， 界 面 如 图 6.24 所 示 。 


DatabaseTest 
CREATE DATABASE 
ADD DATA 


UPDATE DATA 


图 6.24 加 入 更 新 数据 按钮 
点 击 一 下 Update data 按钮 后 , 再 次 输入 查询 语句 查看 表 中 的 数据 情况 ,结果 如 图 6.25 所 示 。 


图 6.25 查看 更 新 后 的 数据 


可 以 看 到 ，The Da Vinci Code 这 本 书 的 价格 已 经 被 成 功 改 为 10.99 了 。 
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6.4.5 ”删除 数据 


怎么 样 ? 添加 和 更 新 数据 的 功能 都 还 挺 简 单 的 吧 ,， 代码 也 不 多 , 理解 起 来 又 容易 , 那么 我 们 
要 马不停蹄 地 开始 学 习 下 一 种 操作 了 ， 即 从 表 中 删除 数据 。 

删除 数据 对 你 来 说 应 该 就 更 简单 了 ， 因 为 它 所 需要 用 到 的 知识 点 你 全 部 已 经 学 过 了 。 
SQLiteDatabase 中 提供 了 一 个 delete() 方 法 ,专门 用 于 删除 数据 ， 这 个 方法 接收 3 个 参数 ， 
第 一 个 参数 仍然 是 表 名 ,这 个 已 经 没什么 好 说 的 了 , 第 二 、 第 三 个 参数 又 是 用 于 约束 删除 某 一 行 
或 某 几 行 的 数据 ， 不 指定 的 话 默 认 就 是 删除 所 有 行 。 

是 不 是 理解 起 来 很 轻松 了 ? 那 我 们 就 继续 动手 实践 吧 ， 修 改 activity _ main.xml 中 的 代码 ， 如 
下 所 示 : 


<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:orientation="vertical" 
android:layout width="match parent" 
android:layout height="match parent" 


> 

<Button 
android:id="@+id/delete data" 
android:Tlayout width="match_parent" 
android:layout height="wrap_content" 
android: text="Delete data" 
/> 

</LinearLayout> 


仍然 是 在 布局 文件 中 添加 了 一 个 按钮 ， 用 于 删除 数据 。 然 后 修改 MainActivity 中 的 代码 ， 如 
下 所 示 : 


public class MainActivity extends AppCompatActivity { 
private MyDatabaseHelper dbHelper; 


@Override 

protected void onCreate(Bundle savedInstanceState) { 
super.onCreate(savedInstanceState);, 
setContentView(R.layout.activity main); 
dbHelper = new MyDatabaseHelper(this, "BookStore.db", null, 2); 


Button deleteButton = (Button) findViewById(R.id.delete data); 
deleteButton.setOnClickListener(new View.OnClickListener() { 
@Override 
public void onClick(View v) { 
SQLiteDatabase db = dbHelper.getWwritableDatabase(); 
db.delete("Book", "pages > ?", new String[] { "500" }); 


}); 
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} 


可 以 看 到 ， 我 们 在 删除 按钮 的 点 击 事件 里 指明 去 删除 Book 表 中 的 数据 ， 并 且 通 过 第 二 、 第 
三 个 参数 来 指定 仅 删除 那些 页 数 超过 500 页 的 书 。 当 然 这 个 需求 很 奇怪 ,这 里 也 仅仅 是 为 了 做 个 
测试 。 你 可 以 先 查 看 一 下 当前 Book 表 里 的 数据 ， 其 中 The Lost Symbol 这 本 书 的 页 数 超过 了 500 
页 ， 也 就 是 说 当 我 们 点 击 删除 按钮 时 ， 这 条 记录 应 该 会 被 删除 掉 。 


现在 重新 运行 一 下 程序 ， 界 面 如 几 6.26 所 示 。 


104 
DatabaseTest 


CREATE DATABASE 


ADD DATA 


UPDATE DATA 


DELETE DATA 


图 6.26 加 入 删除 数据 按钮 
点 击 一 下 Delete data 按钮 后 ， 再 次 输入 查询 语句 查看 表 中 的 数据 情况 ， 结 果 如 图 6.27 所 示 。 


图 6.27 查看 删除 后 的 数据 


6.4.6 ”查询 数据 
终于 到 了 最 后 一 种 操作 了 ， 掌 握 了 查询 数据 的 方法 之 后 ， 你 就 将 数据 库 的 CRUD 操作 全 部 
学 完了 。 不 过 千 万 不 要 因此 而 放松 ， 因 为 查询 数据 是 CRUD 中 最 复杂 的 一 种 操作 。 


我 们 都 知道 SQL 的 全 称 是 Structured Query Language， 翻 译 成 中 文 就 是 结构 化 查询 语言 。 它 
的 大 部 功能 都 体现 在 “ 查 ” 这 个 字 上 的 ， 而 “增删 改 ” 只 是 其 中 的 一 小 部 分 功能 。 由 于 SQL 查 
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询 涉 及 的 内 容 实在 是 太 多 了 ， 因 此 在 这 里 我 不 准备 对 它 展开 来 讲解 ， 而 是 只 会 介绍 Android 上 的 
查询 功能 。 如 果 你 对 SQL 语言 非常 感 兴趣 ， 可 以 找 一 本 专门 介绍 SQL 的 书 进行 学 习 。 

相信 你 已 经 猜 到 了 ，SQLiteDatabase 中 还 提供 了 一 个 query ( ) 方 法 用 于 对 数据 进行 查询 。 这 
个 方法 的 参数 非常 复杂 ,最短 的 一 个 方法 重 载 也 需要 传人 7 个 参数 。 那 我 们 就 先 来 看 一 下 这 7 个 
参数 各 自 的 含义 吧 。 第 一 个 参数 不 用 说 ， 当 然 还 是 表 名 ， 表 示 我 们 希望 从 哪 张 表 中 查询 数据 。 第 
二 个 参数 用 于 指定 去 查询 哪 几 列 ， 如 果 不 指定 则 默认 查询 所 有 列 。 第 三 、 第 四 个 参数 用 于 约束 查 
询 某 一 行 或 某 几 行 的 数据 ,不 指定 则 默认 查询 所 有 行 的 数据 。 第 五 个 参数 用 于 指定 需要 去 group by 
的 列 , 不 指定 则 表示 不 对 查询 结果 进行 group by 操作 。 第 六 个 参数 用 于 对 group by 之 后 的 数据 进 
行进 一 步 的 过 滤 , 不 指定 则 表示 不 进行 过 滤 。 第 七 个 参数 用 于 指定 查询 结果 的 排序 方式 , 不 指定 
则 表示 使 用 默认 的 排序 方式 。 更 多 详细 的 内 容 可 以 参考 下 表 。 其 他 几 个 query() 方 法 的 重 载 其实 
也 大 同 小 异 ， 你 可 以 自己 去 研究 一 下 ， 这 里 就 不 再 进行 介绍 了 。 


query() 方 法 参数 对 应 SQL 部 分 描述 
table from table name 指定 查询 的 表 名 
columns select columnl, column2 指定 查询 的 列 名 
selection where column = value 指定 where 的 约束 条 件 
selectionArgs - 为 where 中 的 占 位 符 提 供 具体 的 值 
groupBy group by column 指定 需要 group by 的 允 
having having column = value 对 group by 后 的 结果 进一步 约束 
orderBy order by columnl, column2 指定 查询 结果 的 排序 方式 


虽然 query() 方 法 的 参数 非常 多 , 但 是 不 要 对 它 产 生 旦 惧 , 因为 我 们 不 必 为 每 条 查询 语句 都 
指定 所 有 的 参数 ， 多 数 情 况 下 只 需要 传人 少数 几 个 参数 就 可 以 完成 查询 操作 了 。 调 用 query() 
方法 后 会 返回 一 个 Cursor 对 象 ， 查 询 到 的 所 有 数据 都 将 从 这 个 对 象 中 取出 。 


下 面 还 是 让 我 们 通过 例子 的 方式 来 体验 一 下 查询 数据 的 具体 用 法 ,修改 activity_main.xml 中 
的 代码 ， 如 下 所 示 : 


<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:orientation="vertical" 
android:layout width="match parent" 
android:layout height="match parent" 
> 


<Button 
android:id="@+id/query_data" 
android:Tlayout width="match_parent" 
android:layout height="wrap_content" 
android:text="Query data" 
/> 
</LinearLayout> 
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这 个 已 经 没什么 好 说 的 了 , 添加 了 一 个 按钮 用 于 查询 数据 。 然 后 修改 MainActivity 中 的 代码 ， 
如 下 所 示 : 


public class MainActivity extends AppCompatActivity { 


private MyDatabaseHelper dbHeLper; 


GOverride 

protected void onCreate(Bundle savedInstanceState) { 
super.onCreate(savedInstanceState); 
setContentView(R.layout.activity main); 
dbHelper = new MyDatabaseHelper(this, "BookStore.db", null, 2); 


Button queryButton = (Button) findViewById(R.id.query_data); 
queryButton.setOnClickListener(new View.0nCLickListener() { 
@Override 
public void onClick(View v) { 
SQLiteDatabase db = dbHelper.getWritableDatabase(); 
// 查询 Book 表 中 所 有 的 数据 
Cursor cursor = db.query("Book", null, null, null, null, null, null); 
if (cursor.moveToFirst()) { 
do { 
// 遍历 Cursor 对 象 ， 取 出 数据 并 打印 
String name = cursor.getString(cursor.getColumnIndex 
("name")); 
String author = cursor.getString(cursor.getColumnIndex 
("author")); 
int pages = cursor.getInt(cursor.getColumnIndex("pages")); 
double price = cursor.getDouble(cursor.getColumnIndex 
("price")); 
Log.d("MainActivity", "book name is " + name); 
Log.d("MainActivity", "book author is " + author); 
Log.d("MainActivity", "book pages is " + pages); 
Log.d("MainActivity", "book price is " + price); 
} while (cursor.moveToNext()); 
} 


cursor.close(); 


}); 


可 以 看 到 , 我们 首先 在 查询 按钮 的 点 击 事件 里 面 调用 了 SQLiteDatabase 的 query() 方 法 去 查 
询 数据 。 这 里 的 query() 方 法 非常 简单 ， 只 是 使 用 了 第 一 个 参数 指明 去 查询 Book 表 ， 后面 的 参 
数 全 部 为 null。 这 就 表示 希望 查询 这 张 表 中 的 所 有 数据 , 虽然 这 张 表 中 目前 只 剩 下 一 条 数据 了 。 
查询 完 之 后 就 得 到 了 一 个 Cursor 对 象 , 接着 我 们 调用 它 的 moveToFirst () 方 法 将 数据 的 指针 移 


动 到 多 


一 行 的 位 置 ， 然 后 进入 了 一 个 循环 当中 ， 去 遍历 查询 到 的 每 一 行 数据 。 在 这 个 循环 中 可 以 


通过 Cursor 的 getColumnIndex() 方 法 获取 到 某 一 列 在 表 中 对 应 的 位 置 索引 ， 然 后 将 这 个 索引 
传人 到 相应 的 取 值 方法 中 , 就 可 以 得 到 从 数据 库 中 读 取 到 的 数据 了 。 接着 我 们 使 用 Log 的 方式 将 
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取出 的 数据 打印 出 来 , 借 此 来 检查 一 下 读 取 工 作 有 没有 成 功 完成 。 最 后 别 忘 了 调用 close() 方 法 


来 关闭 Cursor。 
好 了 ， 现 在 再 次 重新 运行 程序 ， 界 面 如 图 6.28 所 示 。 


0 1:16 
DatabaseTest 


CREATE DATABASE 


ADD DATA 


UPDATE DATA 


DELETE DATA 


QUERY DATA 


图 6.28 ”加 入 查询 数据 按钮 
点 击 一 下 Query data 按钮 后 ， 查 看 logcat 的 打印 内 容 ， 结 果 如 图 6.29 所 示 。 


example. databasetes 


t 

example. databasetes 
t 
t 


example. databasetes 
example. databasetes 


图 6.29 ”打印 查询 到 的 数据 
可 以 看 到 ， 这 里 已 经 将 Book 表 中 唯一 的 一 条 数据 成 功 地 读 取 出 来 了 。 


Q ana 
8eee 
Bae 


t D/MainActivity: book price is 10.99 


当然 这 个 例子 只 是 对 查询 数据 的 用 法 进行 了 最 简单 的 示范 , 在 真正 的 项 目 中 你 


这 要 复杂 得 多 的 查询 功能 , 更 多 高 级 的 用 法 还 需要 你 自己 去 慢 慢 摸索 , 毕竟 query 
那么 多 的 参数 我 们 都 还 没 用 到 呢 。 


6.4.7 ”使 用 SQL 操作 数据 库 


虽然 Android 已 经 给 我 们 提供 了 很 多 非常 方便 的 API 用 于 操作 数据 库 , 不 过 总 
习惯 去 使 用 这 些 辅助 性 的 方法 ， 而 是 更 加 青睐 于 直接 使 用 SQL 来 操作 数据 库 。 这 种 人 一 般 都 属 


可 能 会 遇 到 比 


() 方 法 中 还 有 


会 有 一 些 人 不 


二} 


于 SQL 大 牛 ， 如 果 你 也 是 其 中 之 一 的 话 ,那么 恭喜 ，Android 充分 考虑 到 了 你 们 的 编程 习惯 ， 同 


样 提供 了 一 系列 的 方法 ， 使 得 可 以 直接 通过 SQL 来 操作 数据 库 。 


下 面 我 就 来 简略 演示 一 下 ， 如 何 直 接 使 用 SQL 来 完成 前 面 几 小 节 中 学 过 的 CRUD 操作 。 
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口 添加 数据 的 方法 如 下 : 
db .execSQL("insert into Book (name，author，pages，price) values(?, ?, ?, ?)", 
new String[] { "The Da Vinci Code", "Dan Brown", "454", "16.96" }); 


db.execSQL("insert into Book (name, author, pages, price) values(?, ?, ?, ?)", 
new String[] { "The Lost Symbol", "Dan Brown", "510", "19.95" }); 


口 更 新 数据 的 方法 如 下 : 


db.execSQL("update Book set price = ? where name = ?", new String[] { "10.99", 
"The Da Vinci Code" }); 


口 删除 数据 的 方法 如 下 : 
db.execSQL("delete from Book where pages > ?", new String[] { "500" }); 
口 查询 数据 的 方法 如 下 : 
db.rawQuery("select * from Book", null); 
可 以 看 到 ， 除 了 查询 数据 的 时 候 调 用 的 是 SQLiteDatabase 的 rawQuery () 方 法 ， 其 他 的 操作 
都 是 调用 的 execSQL() 方 法 。 以 上 演示 的 几 种 方式 ， 执 行 结果 会 和 前 面 几 小 节 中 我 们 学 习 的 
CRUD 操作 的 结果 完全 相同 ， 选 择 使 用 哪 一 种 方式 就 看 你 个 人 的 喜好 了 。 


6.5 使 用 LitePal 操作 数据 库 


上 一 节 中 我 们 学 习 了 使 用 SQLiteDatabase 来 操作 SQLite 数据 库 的 方法 ， 你 党 得 好 用 吗 ? 每 
个 人 的 回答 可 能 会 不 一 样 。 但 我 相信 ， 等 学 完了 本 节 的 内 容 之 后 ， 你 将 再 也 不 想 去 碰 
SQLiteDatabase 了 。 到 底 是 什么 东西 这 么 神奇 ?新建 一 个 LitePalTest 项目 ,然后 开始 我 们 本 节 的 
学 习 之 旅 吧 。 


6.5.1 LitePal 简介 


如 今 ，Android 的 学 习 环 境 比 起 我 当年 学 习 的 时 候 已 经 好 太 多 了 。 当 时 国内 做 Android 的 人 
并 不 多 ,各 种 学 习 资料 也 比较 欠缺 ,一 个 项 目 中 几乎 所 有 的 功能 都 要 完全 靠 自己 从 头 来 实现 , 开 
发 效率 之 低下 可 想 而 知 。 

而 现在 开源 的 热潮 让 所 有 Android 开 发 者 都 大 大 受益 ,GitHub 上 面 有 成 百 上 千 的 优秀 Android 
开源 项 目 , 很 多 之 前 我 们 要 写 很 久 才 能 实现 的 功能 , 使 用 开源 库 可 能 短 短 几 分 钟 就 能 实现 了 。 除 
此 之 外 ,公司 里 的 代码 非常 强调 稳定 性 ,而 我 们 自己 写 出 的 代码 往往 越 复杂 就 越 容易 出 问题 。 相 
反 , 开源 项 目的 代码 都 是 经 过 时 间 验 证 的 , 通常 比 我 们 自己 的 代码 要 稳定 得 多 。 因 此 ,现在 有 很 
多 公司 为 了 追求 开发 效率 以 及 项 目 稳 定性 ， 都 会 选择 使 用 开源 库 。 

本 书 中 我 们 将 会 学 习 多 个 开源 库 的 使 用 方法 ， 而 现在 你 将 正式 开始 接触 第 一 个 开源 
LitePal。 


库 
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LitePal 是 一 款 开 源 的 Android 数据 库 框 架 , 它 采 用 了 对 象 关系 映射 (ORM ) 的 模式 ,并 将 我 
们 平时 开发 最 常用 到 的 一 些 数 据 库 功能 进行 了 封装 ， 使 得 不 用 编写 一 行 SQL 语句 就 可 以 完成 各 
种 建 表 和 增删 改 查 的 操作 。LitePal 的 项 目 主页 上 也 有 详细 的 使 用 文档 , 地 址 是 : https://github.com/ 
LitePalFramework/LitePal。 


6.5.2 配置 LitePal 


那么 怎样 才能 在 项 目 中 使 用 开源 库 呢 ? 过 去 的 方式 比较 复杂 ， 通 常 需要 下 载 开源 库 的 Jar 包 
或 者 源码 ， 然 后 再 集成 到 我 们 的 项 目 当 中 。 而 现在 就 简单 得 多 了 , 大 多 数 的 开源 项 目 都 会 将 版 本 
提交 到 jcenter 上 ， 我 们 只 需要 在 app/build.gradle 文件 中 声明 该 开源 库 的 引用 就 可 以 了 。 


因此 , 要 使 用 LitePal 的 第 一 步 ， 就 是 编辑 app/build.gradle 文件 , 在 dependencies 闭 包 中 添加 
如 下 内 容 : 


dependencies { 
compile fileTree(dir: 'libs', include: ['*.jar']) 
compile 'com.android,.support:appcompat-v7:23.2.0" 
testCompile 'junit:junit:4.12'" 
compile 'org.litepal.android:core:1.4.1' 


} 


添加 的 这 一 行 声 明 中 ， 前 面部 分 是 固定 的 ， 最 后 的 1.4.1 是 版 本 号 的 意思 ， 最 新 的 版 本 号 可 
以 到 LitePal 的 项 目 主页 上 去 查看 。 

这 样 我 们 就 把 LitePal 成 功 引入 到 当前 项 目 中 了 ， 接 下 来 需要 配置 litepal.xml 文件 。 右 击 
app/src/main 目录 一 New 一 Directory， 创建 一 个 assets 目录 ， 然 后 在 assets 目录 下 再 新 建 一 个 
litepal.xml 文件 ， 接 着 编辑 litepal.xml 文件 中 的 内 容 ， 如 下 所 示 : 

<?xml version="1.0" encoding="utf-8"?> 


<litepal> 
<dbname value="BookStore" ></dbname> 


<version value="1" ></version> 


<list> 
</list> 
</litepal> 


其 中 ，<dbname> 标 签 用 于 指定 数据 库 名 ，<version> 标 签 用 于 指定 数据 库 版 本 号 ，<List> 
标签 用 于 指定 所 有 的 映射 模型 ， 我 们 稍 后 就 会 用 到 。 


最 后 还 需要 再 配置 一 下 LitePalApplication ， 修 改 AndroidManifest.xml 中 的 代码 ， 如 下 所 示 : 


<manifest xmlns:android="http://schemas.android.com/apk/res/android" 
package="com.example.litepaltest"> 
<application 
android:name="org.litepal .LitePalApplication" 
android:allowBackup="true" 
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android:icon="@mipmap/ic launcher" 
android:label="@string/app_name" 
android:supportsRtl="true" 
android:theme="@style/AppTheme"> 


</application> 
</manifest> 
这 里 我 们 将 项 目的 appLication 配置 为 org.litepal.LitePalApplication， 这 样 才能 
让 LitePal 的 所 有 功能 都 可 以 正常 工作 。 关 于 application 的 作用 ， 我们 之 前 并 没有 进行 过 详 
细 的 讲解 ， 现 在 你 只 需要 知道 必须 这 么 写 就 行 了 ， 我 们 将 会 在 第 13 章 中 学 习 appLication 的 
更 多 内 容 。 
现在 LitePal 的 配置 工作 已 经 全 部 结束 了 ， 下 面 我 们 开始 正式 使 用 它 吧 


6.5.3 创建 和 升级 数据 库 


我 们 之 前 创建 数据 库 是 通过 自 定 义 一 个 类 继承 自 SQLiteOpenHelper， 然 后 在 onCreate() 方 
法 中 编写 建 表 语句 来 实现 的 ， 而 使 用 LitePal 就 不 用 再 这 么 麻烦 了 。 本 节 中 我 们 会 使 用 LitePal 来 
逐一 完成 上 一 节 中 所 学 的 所 有 功能 ， 以 此 来 对 比 它们 之 间 的 差距 , 那么 为 了 方便 测试 ,我们 先 将 
activity_main.xml 布局 文件 从 DatabaseTest 项 目 复 制 到 LitePalTest 项目 中 来 。 

刚才 在 介绍 的 时 候 已 经 说 过 ，LitePal 采取 的 是 对 象 关系 映射 (ORM ) 的 模式 ， 那 么 什么 是 
对 象 关系 映射 呢 ? 简单 点 说 , 我 们 使 用 的 编程 语言 是 面向 对 象 语言 ， 而 使 用 的 数据 库 则 是 关系 型 
数据 库 , 那么 将 面向 对 象 的 语言 和 面向 关系 的 数据 库 之 间 建 立 一 种 映射 关系 ,这 就 是 对 象 关系 映 
射 了 。 

不 过 你 可 千 万 不 要 小 看 对 象 关系 映射 模式 ， 它 赋予 了 我 们 一 个 强大 的 功能 ,就 是 可 以 用 面向 
对 象 的 思维 来 操作 数据 库 ， 而 不 用 再 和 SQL 语句 打交道 了 ， 不 信 的 话 我 们 现在 就 来 体验 一 下 。 
比如 在 6.4.1 小 节 中 , 为 了 创建 一 张 Book 表 , 需要 先 分 析 表 中 应 该 包含 哪些 列 , 然后 再 编写 出 
条 建 表 语句 ， 最 后 在 自 定 义 的 SQLiteOpenHelper 中 去 执行 这 条 建 表 语 句 。 但 是 使 用 LitePal， 你 
就 可 以 用 面向 对 象 的 思维 来 实现 同样 的 功能 了 ， 定 义 一 个 Book 类 ， 代码 如 下 所 示 : 

public class Book { 


O 


private int id; 
private String author; 
private double price; 
private int pages; 
private String name; 
public int getId() { 


return id; 


} 
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public void setId(int id) { 
this.id = id; 
} 


public String getAuthor() { 
return author; 


} 


public void setAuthor(String author) { 
this.author = author; 


} 


public double getPrice() { 
return price; 


} 


public void setPrice(double price) { 
this.price = price; 


} 


public int getPages() { 
return pages; 


} 


public void setPages(int pages) { 
this.pages = pages; 
} 


public String getName() { 
return name; 


} 


public void setName(String name) { 
this.name = name; 


} 
} 


这 是 一 个 典型 的 Java bean， 在 Book 类 中 我 们 定义 了 id、author、price、pages、name 这 
几 个 字段 ， 并 生成 了 相应 的 getter 和 setter 方法 。” 相应 你 已 经 能 猪 到 了 ，Book 类 就 会 对 应 
数据 库 中 的 Book 表 ， 而 类 中 的 每 一 个 字段 分 别 对 应 了 表 中 的 每 一 个 列 ， 这 就 是 对 象 关系 映射 最 
直观 的 体验 ， 现 在 你 能 够 理解 得 更 加 清楚 了 吧 。 

接 下 来 我 们 还 需要 将 Book 类 添加 到 映射 模型 列表 当中 ， 修 改 litepal.xml 中 的 代码 ， 如 下 
所 示 : 


<litepal> 
<dbname value="BookStore" ></dbname> 


@ 生成 getter 和 setter 方法 的 快捷 方式 是 , 先 将 类 中 的 字段 定义 好 , 然后 按 下 Alt+ Insert 键 ( Mac 系统 是 command 
+N )， 在 弹出 菜单 中 选择 Getter and Setter， 接 着 使 用 Shift 键 将 所 有 字段 都 选中 ， 最 后 点 击 OK。 
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<version value="1" ></version> 


<list> 
i class="com.example.litepaltest .Book"></mapping> 
</list> 
</litepal> 
这 里 使 用 <mapping> 标 签 来 声明 我 们 要 配置 的 映射 模型 类 , 注意 一 定 要 使 用 完整 的 类 名 。 不 
管 有 多 少 模型 类 需要 映射 ， 都 使 用 同样 的 方式 配置 在 <list> 标 签 下 即 可 。 
没 错 , 这 样 就 已 经 把 所 有 工作 都 完成 了 , 现在 只 要 进行 任意 一 次 数据 库 的 操作 , BookStore.db 
数据 库 应 该 就 会 自动 创建 出 来 。 那 么 我 们 修改 MainActivity 中 的 代码 ， 如 下 所 示 : 


public class MainActivity extends AppCompatActivity { 


GOverride 
protected void onCreate(Bundle savedInstanceState) { 
super.onCreate(savedInstanceState); 
setContentView(R.layout.activity main); 
Button createDatabase = (Button) findViewById(R.id.create database); 
createDatabase.setOnClickListener(new View.OnClickListener() { 
@Override 
public void onClick(View v) { 
LitePal .getDatabase(); 


}); 


其 中 ,调用 LitePal .getDatabase() 方 法 就 是 一 次 最 简单 的 数据 库 操作 ， 只 要 点 击 一 下 按 
钮 ， 数 据 库 就 会 自动 创建 完成 了 。 运 行 一 下 程序 ， 然 后 点 击 Create database 按钮 ， 接 着 通过 adb 
shell 查看 一 下 数据 库 创 建 情况 ， 如 图 6.30 所 示 。 


图 6.30 ”查看 数据 库 文件 
非常 棒 ! 数据 库 文件 已 经 创建 成 功 了 。 接 下 来 我 们 使 用 sqlite3 命令 打开 BookStore.db 文 


件 ， 然 后 再 使 用 .schema 命令 来 查看 建 表 语句 ， 如 图 6.31 所 示 。 
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图 6.31 查看 建 表 语句 


可 以 看 到 ， 这 里 有 3 张 表 的 建 表 语句 ， 其 中 android _metadata 表 仍 然 不 用 管 ，tabte 
schema 表 是 LitePal 内 部 使 用 的 ,我 们 也 可 以 直接 忽视 ，book 表 就 是 根据 我 们 定义 的 Book 类 以 
及 类 中 的 字段 来 自动 生成 的 了 。 

怎么 样 ， 是 不 是 很 神奇 ? 但 不 用 太 吃 惊 ， 因 为 更 加 神奇 的 还 在 后 面 呢 。6.4.2 节 中 我 们 体验 
了 使 用 SQLiteOpenHelper 来 升级 数据 库 的 方式 ， 虽 说 功能 是 实现 了 , 但 你 有 没有 发 现 一 个 问题 ， 
就 是 升级 数据 库 的 时 候 我 们 需要 先 把 之 前 的 表 drop 掉 ， 然 后 再 重新 创建 才 行 。 这 其 实 是 一 个 非 
常 严 重 的 问题 ， 因 为 这 样 会 造成 数据 丢失 ， 每 当 升 级 一 次 数据 库 ， 之 前 表 中 的 数据 就 全 没 了 。 

当然 如 果 你 是 非常 有 经 验 的 程序 员 , 也 可 以 通过 复杂 的 逻辑 控制 来 避免 这 种 情况 , 但 是 维护 
成 本 很 高 。 而 有 了 LitePal， 这 些 就 都 不 再 是 问题 了 ， 使 用 LitePal 来 升级 数据 库 非常 非常 简单 ， 
你 完全 不 用 思考 任何 的 逻辑 ， 只 需要 改 你 想 改 的 任何 内 容 ， 然 后 将 版 本 号 加 1 就 行 了 。 


比如 我 们 想 要 向 Book 表 中 添加 一 个 press ( 出 版 社 ) 列 ， 直 接 修 改 Book 类 中 的 代码 ， 添 加 
一 个 press 字段 即 可 ， 如 下 所 示 : 


/ 


public class Book { 


private String press; 


public String getPress() { 
return press; 


} 
public void setPress(String press) { 


this.press = press; 


} 
} 


与 此 同时 ， 我 们 还 想 再 添加 一 张 Category 表 ， 那 么 只 需要 新 建 一 个 Category 类 就 可 以 了 ， 
代码 如 下 所 示 : 


public class Category { 


private int id; 
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private String catego 

private int categoryC 

public void setId(int 
this.id = id; 

} 


public void setCatego 
this.categoryName 


} 
public void setCatego 
this.categoryCode 
} 
} 


改 完 了 所 有 我 们 想 改 的 东西 


<litepal> 
<dbname value="BookSt 


<version value="2" >< 


<list> 
<mapping class="Cc 
<mapping class="c 

</list> 

</litepal> 


ryName; 
ode; 


id) { 


ryName (String categoryName) { 
= CategoryName ; 


ryCode(int categoryCode) { 
= CategoryCode; 


， 只 需要 记得 将 版 本 号 加 1 就 行 了 。 当 然 由 于 这 里 还 添加 了 一 个 


新 的 模型 类 ， 因 此 也 需 要 将 它 添加 到 映射 模型 列表 中 修改 litepal.xml 中 的 代码 ， 如 下 所 示 : 


ore" ></dbname> 


/version> 


om.example. litepaltest.Book"></mapping> 
om.example.litepaltest.Category"></mapping> 


现在 重新 运行 一 下 程序 ， 然 后 点 击 Create database 按钮 ， 再 查看 一 下 最 新 的 建 表 语句 ， 结 


如 图 6.32 所 示 。 


可 以 看 到 ，book 表 中 新 增 了 


图 6.32 升级 数据 库 后 的 建 表 语 句 


A de 全 玖 和 


我 们 做 了 一 项 非常 重要 的 工作 , 就 是 保留 之 前 表 中 的 所 有 数据 , 这 样 就 再 也 不 用 担心 数据 丢失 的 


问题 了 。 
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6.5.4 使 用 LitePal 添加 数据 


体验 了 使 用 LitePal 来 创建 和 升级 数据 库 , 是 不 是 感觉 已 经 有 一 些小 震撼 了 呢 ? 不 过 LitePal 
所 提供 的 强大 功能 还 远 不 止 于 此 ， 接 下 来 我 们 就 学 习 一 下 如 何 使 用 它 来 向 数据 库 的 表 中 添加 数 
据 吧 。 

首先 回顾 一 下 之 前 添加 数据 的 方法 ,我们 需要 创建 出 一 个 ContentValues 对 象 ， 然 后 将 所 
有 要 添加 的 数据 put 到 这 个 ContentValues 对 象 当中 , 最 后 再 调用 SQLiteDatabase 的 insert() 
方法 将 数据 添加 到 数据 库 表 当 中 。 

而 使 用 LitePal 来 添加 数据 ， 这 些 操 作 可 以 简单 到 让 你 惊叹 ! 我 们 只 需要 创建 出 模型 类 的 实 
例 ， 再 将 所 有 要 存储 的 数据 设置 好 ， 最 后 调用 一 下 save() 方 法 就 可 以 了 。 

下 面 开 始 来 动手 实现 ， 观 察 现 有 的 模型 类 ， 你 会 发 现 它 们 都 是 没有 继承 结构 的 。 没 错 ， 因 为 
LitePal 进行 表 管理 操作 时 不 需要 模型 类 有 任何 的 继承 结构 ， 但 是 进行 CRUD 操作 时 就 不 行 了 ， 
必须 要 继承 自 DataSupport 类 才 行 , 因此 这 里 我 们 需要 先 把 继承 结构 给 加 上 。 修改 Book 类 中 的 
代码 ， 如 下 所 示 : 


public class Book extends DataSupport { 


} 
接着 我 们 开始 向 Book 表 中 添加 数据 ， 修 改 MainActivity 中 的 代码 ， 如 下 所 示 : 


public class MainActivity extends AppCompatActivity { 


@Override 

protected void onCreate(Bundle savedInstanceState) { 
super.onCreate(savedInstanceState); 
setContentView(R.layout.activity main); 


Button addData = (Button) findViewById(R.id.add data); 
addData.setOnClickListener(new View.0nCLickListener() { 
@Override 
public void onClick(View v) { 
Book book = new Book(); 
book.setName("The Da Vinci Code"); 
book. setAuthor("Dan Brown"); 
book. setPages (454); 
book. setPrice(16.96); 
book. setPress("Unknow"); 
book. save(); 


}); 


} 
这 上段 代码 非常 神奇 ,我 们 来 仔细 阅读 一 下 。 在 添加 数据 按钮 的 点 击 事件 里 面 ,首先 是 创建 出 
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了 一 个 Book 的 实例 ， 然 后 调用 Book 类 中 的 各 种 set 方法 对 数据 进行 设置 ， 最 后 再 调用 
book. save() 方 法 就 能 完成 数据 添加 操作 了 。 那 么 这 个 save() 方 法 是 从 哪儿 来 的 呢 ? 当然 是 从 
DataSupport 类 中 继承 而 来 的 了 。 除了 save() 方 法 之 外 ,DataSupport 类 还 给 我 们 提供 了 丰富 
的 CRUD 方法 ， 这 些 我 们 在 后 面 都 会 学 到 。 

现在 重新 运行 程序 ， 点 击 一 下 Add data 按钮 ， 此 时 数据 应 该 已 经 添加 成 功 了 ， 我 们 打开 
BookStore.db 数据 库 瞧 一 瞧 。 输 入 SQL 查询 语句 select * from Book， 结果 如 图 6.33 所 示 。 


图 6.33 ”查看 添加 的 数据 
可 以 看 到 ， 作 者 、 书 名 、 页 数 、 价 格 、 出 版 社 ， 这 些 数 据 全 部 精确 无 误 地 添加 成 功 了 。 


6.5.5 ”使 用 LitePal 更 新 数据 


学 习 完 了 如 何 使 用 LitePal 添加 数据 ， 接 下 来 我 们 看 看 怎样 使 用 LitePal 更 新 数据 。 更 新 数据 
要 比 添加 数据 稍微 复杂 一 点 ,因为 它 的 API 接 口 比 较 多 ,这 里 我 们 只 介绍 最 常用 的 几 种 更 新 方式 。 

首先 ， 最 简单 的 一 种 更 新 方式 就 是 对 已 存储 的 对 象 重 新 设 值 ， 然 后 重新 调用 save() 方 法 即 
可 。 那 么 这 里 我 们 就 要 了 解 一 个 概念 ， 什 么 是 已 存储 的 对 象 ? 

对 于 LitePal 来 说 ， 对 象 是 否 已 存储 就 是 根据 调用 model.isSaved() 方 法 的 结果 来 判断 的 ， 
返回 true 就 表示 已 存储 , 返回 false 就 表示 未 存储 。 那么 接 下 来 的 问题 就 是 ， 什 么 情况 下 会 返 
回 true， 什 么 情况 下 会 返回 false 呢 ? 

实际 上 只 有 在 两 种 情况 下 modet,isSaved() 方 法 才 会 返回 true， 一 种 情况 是 已 经 调用 过 
modeL.save() 方 法 去 添加 数据 了 ， 此 时 model 会 被 认为 是 已 存储 的 对 象 。 另 一 种 情况 是 model 
对 象 是 通过 LitePal 提供 的 查询 API 查 出 来 的 ， 由 于 是 从 数据 库 中 查 到 的 对 象 ， 因 此 也 会 被 认为 
是 已 存储 的 对 象 。 

由 于 查询 API 我 们 暂时 还 没 学 到 ,因此 只 能 先 通 过 第 一 种 情况 来 进行 验证 ,修改 MainActivity 
中 的 代码 ， 如 下 所 示 : 


public class MainActivity extends AppCompatActivity { 


@Override 

protected void onCreate(Bundle savedInstanceState) { 
super.onCreate(savedInstanceState); 
setContentView(R.layout.activity main); 


Button updateData = (Button) findViewById(R.id.update data); 
updateData.setOnClickListener(new View.0nCLickListener() { 
@Override 
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public vo 
Book 
book. 
book. 
book. 
book. 
book. 
book. 
book. 
book. 


}); 


在 更 新 数据 按钮 的 点 击 事件 里 面 ， 我 们 先是 通过 上 


id onClick(View v) { 

book = new Book(); 
setName("The Lost Symbol"); 
setAuthor("Dan Brown"); 
setPages(510); 
setPrice(19.95); 
setPress("Unknow"); 

save(); 

setPrice(10.99); 

save(); 


小 节 中 学 习 的 知识 添加 了 一 条 Book 数 


据 , 然后 调用 setPrice() 方 法 将 这 本 书 的 价格 进行 了 修改 , 之 后 再 次 调用 了 save( ) 方 法 。 此 时 
LitePal 会 发 现 当前 的 Book 对 象 是 已 存储 的 ， 因 此 不 会 再 向 数据 库 中 去 添加 一 条 新 数据 ， 而 


直接 更 新 当前 的 数据 。 


月 .分 
是 会 


现在 重新 运行 一 下 程序 ， 然 后 点 击 Update data 按钮 ， 我 们 再 次 输入 查询 语句 查看 表 中 的 数 


据 情况 ， 结 果 如 图 6.34 所 示 


O 


图 6.34 查看 更 新 后 的 数据 


可 以 看 到 ，Book 表 中 新 增 了 一 条 书 的 数据 ,但 这 本 书 的 价格 并 不 是 一 开始 设置 的 19.95， 而 


是 10.99， 说 明 我 们 的 更 新 操作 确实 生效 了 。 


更 加 灵巧 的 更 新 方式 。 修 改 


public class MainActi 


@Override 

protected void on 
super.onCreat 
setContentVie 


Button update 
updateData.se 
@Override 
public vo 
Book 

book. 


MainActivity 中 的 代码 ， 如 下 所 示 : 
vity extends AppCompatActivity { 


Create(Bundle savedInstanceState) { 
e(savedInstanceState); 
w(R.layout.activity main); 


Data = (Button) findViewById(R.id.update data); 
tOnClickListener(new View.0nCLickListener() { 


id onClick(View v) { 
book = new Book(); 
setPrice(14.95); 


但 是 这 种 更 新 方式 只 能 对 已 存储 的 对 象 进行 操作 , 限制 性 比较 大 , 接 下 来 我 们 学 习 男 外 一 种 
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book.setPress("Anchor"); 
book.updateAll ("name = ? and author = ?", "The Lost Symbol", "Dan 
Brown'" ) ; 


可 以 看 到 ， 这 里 我 们 首先 new 出 了 一 个 Book 的 实例 ， 然 后 直接 调用 setPrice() 和 
setPress() 方 法 来 设置 要 更 新 的 数据 ， 最 后 再 调用 updateALL( ) 方 法 去 执行 更 新 操作 。 注 意 
updateALL() 方 法 中 可 以 指定 一 个 条 件 约束 ， 和 SQLiteDatabase 中 update() 方 法 的 where 参数 
部 分 有 点 类 似 , 但 更 加 简洁 ， 如 果 不 指定 条 件 语 名 的话， 就 表示 更 新 所 有 数据 。 这 里 我 们 指定 将 
所 有 书 名 是 The Lost Symbol 并 且 作 者 是 Dan Brown 的 书 价格 更 新 为 14.95 ,出 版 社 更 新 为 Anchor。 

现在 重新 运行 程序 并 点 击 Update data 按钮 ， 我 们 再 次 查询 一 下 表 中 的 数据 情况 ， 结 果 如 
6.35 所 示 。 


图 6.35 再 次 查看 更 新 后 的 数据 


意料 之 中 ， 第 二 本 书 的 价格 被 更 新 成 了 14.95， 出 版 社 被 更 新 成 了 Anchor。 怎 么 样 ? LitePal 
的 更 新 API 是 不 是 明显 比 SQLiteDatabase 的 update( ) 方 法 要 好 用 多 了 ? 

不 过 ,在 使 用 updateALL() 方 法 时 ， 还 有 一 个 非常 重要 的 知识 点 是 你 需要 知晓 的 ， 就 是 当 
你 想 把 一 个 字段 的 值 更 新 成 默认 值 时 ,是 不 可 以 使 用 上 面 的 方式 来 set 数据 的 。 我 们 都 知道 , 在 
Java 中 任何 一 种 数据 类 型 的 字段 都 会 有 默认 值 , 例如 int 类 型 的 默认 值 是 0，boolean 类 型 的 默 
认 值 是 false，String 类 型 的 默认 值 是 nuLL。 那 么 当 new 出 一 个 Book 对 象 时 ， 其 实 所 有 字段 
都 已 经 被 初 识 化 成 默认 值 了 ， 比 如 说 pages 字段 的 值 就 是 0。 因 此， 如 果 我 们 想 把 数据 库 表 中 的 
pages 列 更 新 成 0, 直接 调用 book.setPages(0) 是 不 可 以 的 , 因为 即使 不 调用 这 行 代码 , pages 
字段 本 身 也 是 0，LitePal 此 时 是 不 会 对 这 个 列 进行 更 新 的 。 对 于 所 有 想 要 将 为 数据 更 新 成 默认 值 
的 操作 ，LitePal 统一 提供 了 一 个 setToDefault() 方 法 , 然后 传人 相应 的 列 名 就 可 以 实现 了 。 比 
如 我 们 可 以 这 样 写 : 

Book book = new Book(); 


book.setToDefault("pages"); 
book.updateAll (); 


这 段 代码 的 意思 是 , 将 所 有 书 的 页 数 都 更 新 为 0, 因为 updateALL( ) 方 法 中 没有 指定 约束 条 
件 ， 因 此 更 新 操作 对 所 有 数据 都 生效 了 。 


A 
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6.5.6 使 用 LitePal 删除 数据 
使 用 LitePal 删除 数据 的 方式 主要 有 两 种 ， 第 一 种 比较 简单 ， 就 是 直接 调用 已 存储 对 象 的 
delete() 方 法 就 可 以 了 ,对 于 已 存储 对 象 的 概念 ， 我们 在 上 一 小 节 中 已 经 学 习 过 了 。 也 就 是 说 ， 
调用 过 save() 方 法 的 对 象 , 或 者 是 通过 LitePal 提供 的 查询 API 查 出 来 的 对 象 , 都 是 可 以 直接 使 
用 delete() 方 法 来 删除 数据 的 。 这 种 方式 比较 简单 ， 我 们 就 不 进行 代码 演示 了 ， 下 面 直接 来 看 
另外 一 种 删除 数据 的 方式 。 

修改 MainActivity 中 的 代码 ， 如 下 所 示 : 


public class MainActivity extends AppCompatActivity { 


@Override 

protected void onCreate(Bundle savedInstanceState) { 
super.onCreate(savedInstanceState);, 
setContentView(R.layout.activity main); 


Button deleteButton = (Button) findViewById(R.id.delete data); 
deleteButton.setOnClickListener(new View.OnClickListener() { 
@Override 
public void onClick(View v) { 
DataSupport.deleteAll (Book.class, "price < ?", "15"); 


} 
}); 


} 

这 里 调用 了 DataSupport.deleteAl1() 方 法 来 删除 数据 , 其 中 deLeteALL( ) 方 法 的 第 一 个 
参数 用 于 指定 删除 哪 张 表 中 的 数据 ，Book.class 就 意味 着 删除 Book 表 中 的 数据 ， 后 面 的 参数 用 
于 指定 约束 条 件 ， 应 该 不 难 理解 。 那 么 这 行 代 码 的 意思 就 是 ， 删 除 Book 表 中 价格 低 于 15 的 书 ， 
正好 目前 Book 表 中 有 两 本 书 ， 一 本 价格 是 16.96， 一 本 价格 是 14.95， 刚 好 可 以 看 出 效果 。 

现在 重新 运行 程序 ， 并 点 击 一 下 Delete data 按钮 ， 然 后 查询 表 中 的 数据 情况 ， 如 图 6.36 
所 示 。 


图 6.36 查看 删除 后 的 数据 
可 以 看 到 ， 价 格 低 于 15 的 那 本 书 已 经 被 删除 掉 了 。 


另外 ,deleteAl1() 方 法 如 果 不 指 定 约束 条 件 ， 就 意味 着 你 要 删除 表 中 的 所 有 数据 ， 这 一 点 
和 updateALL() 方 法 是 比较 相似 的 。 
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6.5.7 ”使 用 LitePal 查询 数据 


终于 又 到 了 最 复杂 的 查询 数据 部 分 了 , 不 过 这 个 “最 复杂 ”只 是 相对 于 过 去 而 言 ， 因 为 使 用 
LitePal 来 查询 数据 一 点 都 不 复杂 。 我 一 直 都 认为 LitePal 在 查询 API 方 面 的 设计 极为 人 性 化 ， 想 
想 之 前 我 们 所 使 用 的 query( ) 方 法 , 宛 长 的 参数 列表 让 人 看 得 头疼 , 即使 多 数 参数 都 是 用 不 到 的 ， 
也 不 得 不 传人 nuLL， 如 下 所 示 : 

Cursor cursor = db.query("Book", null, null, null, null, null, null); 

像 这 样 的 代码 恐怕 是 没 人 会 喜欢 的 。 为 此 LitePal 在 查询 API 方面 做 了 非常 多 的 优化 ， 基 本 
上 可 以 满足 绝 大 多 数 场景 的 查询 需求 ， 并 且 代 码 十 分 整洁 ， 下 面 我 们 就 来 一 起 学 习 一 下 。 

首先 分 析 一 下 上 述 代 码 ，query() 方 法 中 使 用 了 第 一 个 参数 指明 去 查询 Book 表 ， 后 面 的 参 
数 全 部 为 null， 这 就 表示 希望 查询 这 张 表 中 的 所 有 数据 。 那 么 使 用 LitePal 如 何 完 成 同样 的 功能 
呢 ? 非常 简单 ， 只 需要 这 样 写 : 

List<Book> books = DataSupport.findAll (Book.class); 

怎么 样 ,代码 是 不 是 简单 易 懂 多 了 ? 没有 宛 长 的 参数 列表 , 只 需要 调用 一 下 findAl1() 方 法 ， 
然后 通过 Book.class 参数 指定 查询 Book 表 就 可 以 。 另 外 ,findALL() 方 法 的 返回 值 是 一 个 Book 
类 型 的 List 集合 ， 也 就 是 说 ， 我 们 不 用 像 之 前 那样 再 通过 Cursor 对 象 一 行 行 去 取 值 了 ，LitePal 
已 经 自动 帮 有 我 们 完成 了 赋值 操作 。 

下 面 通过 一 个 完整 的 例子 来 实践 一 下 吧 ， 修 改 MainActivity 中 的 代码 ， 如 下 所 示 : 


public class MainActivity extends AppCompatActivity { 


GOverride 

protected void onCreate(Bundle savedInstanceState) { 
super.onCreate(savedInstanceState); 
setContentView(R.layout.activity main); 


Button queryButton = (Button) findViewById(R.id.query_ data); 
queryButton.setOnClickListener(new View.OnClickListener() { 
@Override 
public void onClick(View v) { 
List<Book> books = DataSupport.findAll (Book.class); 
for (Book book: books) { 
Log.d("MainActivity", "book name is " + book.getName()); 
Log.d("MainActivity", "book author is " + book.getAuthor()); 
Log.d("MainActivity", "book pages is " + book.getPages()); 
Log.d("MainActivity", "book price is " + book.getPrice()); 
Log.d("MainActivity", "book press is " + book.getPress()); 


}); 
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查询 的 那 段 代码 刚刚 已 经 解释 过 了 ， 接 下 来 就 是 遍历 List 集 合 中 的 Book 对 象 ， 并 将 其 中 的 
言 息 全 部 打印 出 来 。 现在 重新 运行 一 下 程序 , 点击 Query data 按钮 , 然后 查看 logcat 的 打印 内 容 ， 
结果 如 图 6.37 所 示 。 


Pa 
[vaee 加 6- ) 
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com. example. litepaltest D/MainActivity: book name is The Da Vinci Code 


com. example. litepaltest D/MainActivity: book author is Dan Browmn 
com. example. litepaltest D/MainActivity: book pages is 454 
com. example. litepaltest D/MainActivity: book price is 16.96 


com. example. litepaltest D/MainActivity: book press is Unknow 


图 6.37 打印 查询 到 的 数据 


Book 表 中 只 剩 下 一 条 数据 ， 由 此 可 见 ， 我 们 已 经 将 这 条 数据 成 功 查 询 出 来 了 。 
除了 findALL() 方 法 之 外 , LitePal 还 提供 了 很 多 其 他 非常 有 用 的 查询 API。 比 如 我 们 想 要 查 
询 Book 表 中 的 第 一 条 数据 就 可 以 这 样 写 : 
Book firstBook = DataSupport.findFirst(Book.class); 
查询 Book 表 中 的 最 后 一 条 数据 就 可 以 这 样 写 : 
Book LastBook = DataSupport.findLast(Book.class); 
我 们 还 可 以 通过 连 级 查询 来 定制 更 多 的 查询 功能 。 
口 select() 方 法 用 于 指定 查询 哪儿 列 的 数据 ， 对 应 了 SQL 当中 的 select 关键 字 。 比 如 只 
查 name 和 author 这 两 列 的 数据 ， 就 可 以 这 样 写 : 
List<Book> books = DataSupport.select("name", "author").find(Book.class); 


口 where() 方 法 用 于 指定 查询 的 约束 条 件 ， 对 应 了 SQL 当中 的 where 关键 字 。 比 如 只 查 页 
数 大 于 400 的 数据 ， 就 可 以 这 样 写 : 


List<Book> books = DataSupport.where("pages > ?", "400").find(Book.class); 


口 order() 方 法 用 于 指定 结果 的 排序 方式 ， 对 应 了 SQL 当中 的 order by 关键 字 。 比 如 将 
查询 结果 按照 书 价 从 高 到 低 排 序 ， 就 可 以 这 样 写 : 


List<Book> books = DataSupport.order("price desc").find(Book.class); 

其 中 desc 表示 降序 排列 ，asc 或 者 不 写 表示 升序 排列 。 
口 Limit() 方 法 用 于 指定 查询 结果 的 数量 ， 比 如 只 查 表 中 的 前 3 条 数据 ， 就 可 以 这 样 写 : 
List<Book> books = DataSupport. limit(3).find(Book.class); 


口 offset() 方 法 用 于 指定 查询 结果 的 偏 移 量 ， 比 如 查询 表 中 的 第 2 条 、 第 3 条 、 第 4 条 数 
据 ， 就 可 以 这 样 写 : 


List<Book> books = DataSupport.limit(3).offset(1).find(Book.class); 
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由 于 Limit(3) 查 询 到 的 是 前 3 条 数据 ， 这 里 我 们 再 加 上 offset(1) 进 行 一 个 位 置 的 偏 移 ， 
就 能 实现 查询 第 2 条 、 第 3 条 、 第 4 条 数据 的 功能 了 。Limit() 和 offset () 方 法 共同 对 应 了 SQL 
当中 的 Limit 关键 字 。 
当然 ， 你 还 可 以 对 这 5 个 方法 进行 任意 的 连 级 组 合 ， 来 完成 一 个 比较 复杂 的 查询 操作 : 
List<Book> books = DataSupport.select("name", "author", "pages") 
.Where("pages > ?", "400") 
.Order("pages") 
.Limit(10) 
.offset(10) 
.find(Book.class); 
这 上段 代码 就 表示 ， 查 询 Book 表 中 第 11~20 条 满足 页 数 大 于 400 这 个 条 件 的 name 、author 
和 pages 这 3 列 数据 ， 并 将 查询 结果 按照 页 数 升序 排列 。 
怎么 样 ? 是 不 是 感觉 LitePal 的 查询 功能 非常 强大 ， 并 且 代 码 明 显 更 加 简洁 ? 我 们 需要 用 到 
一 个 方法 的 时 候 直 接连 级 一 下 就 可 以 了 ,不 需要 的 话 就 可 以 不 写 , 而 不 是 像 之 前 的 query () 方 法 ， 
不 管 需 不 需要 用 到 ， 都 必须 要 传 固 定 的 参数 进去 才 行 。 
关于 LitePal 的 查询 API 差不多 就 介绍 到 这 里 ， 这 些 API 已 经 足够 我 们 应 对 绝 大 多 数 场景 的 
查询 需求 了 。 当 前 ,如果 你 实在 有 一 些 特殊 需求 ， 上述 的 API 都 满足 不 了 你 的 时 候 ，LitePal 仍然 
支持 使 用 原生 的 SQL 来 进行 查询 : 


Cursor c = DataSupport.findBySQL("select * from Book where pages > ? and price < ?", 
"400" ， "20"); 


/ 


调用 DataSupport.findBySQL() 方 法 来 进行 原生 查询 ， 其 中 第 一 个 参数 用 于 指定 SQL 语 
句 , 后 面 的 参数 用 于 指定 占 位 符 的 值 。 注意 findBySQL() 方 法 返回 的 是 一 个 Cursor 对 象 , 接 下 
来 你 还 需要 通过 之 前 所 学 的 老 方式 将 数据 一 一 取出 才 行 。 


6.6 小结 与 点 评 


经 过 了 这 一 章 漫 长 的 学 习 , 我 们 终于 可 以 缓解 一 下 疲劳 , 对 本 章 所 学 的 知识 进行 梳理 和 总 结 
了 。 本 章 主 要 是 对 Android 常用 的 数据 持久 化 方式 进行 了 详细 的 讲解 ， 包 括 文件 存储 、 
SharedPreferences 存储 以 及 数据 库存 储 。 其 中 文件 适用 于 存储 一 些 简单 的 文本 数据 或 者 二 进 制 数 
据 ，SharedPreferences 适用 于 存储 一 些 键 值 对 ， 而 数据 库 则 适用 于 存储 那些 复杂 的 关系 型 数据 。 
虽然 目前 你 已 经 掌握 了 这 3 种 数据 持久 化 方式 的 用 法 , 但 是 能 够 根据 项 目的 实际 需求 来 选择 最 合 
适 的 方式 也 是 你 未 来 需要 继续 探索 的 。 

那么 正如 上 一 章 小 结 里 提 到 的 ， 既 然 现在 我 们 已 经 掌握 了 Android 中 的 数据 持久 化 技术 ， 接 
下 来 就 应 该 继续 学 习 Android 中 剩余 的 四 大 组 件 了 。 放 松 一 下 自己 ， 然 后 一 起 踏 上 内 容 提供 器 的 
学 习 之 旅 吧 。 
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跨 程序 共享 数据 一 一 探究 内 容 提 供 器 


在 上 一 章 中 我 们 学 了 Android 数据 持久 化 的 技术 ， 包括 文 件 存 储 、SharedPreferences 存储 以 
及 数据 库存 储 。 不 知道 你 有 没有 发 现 , 使 用 这 些 持久 化 技术 所 保存 的 数据 都 只 能 在 当前 应 用 程序 中 
访问 。 虽 然 文 件 和 SharedPreferences 存储 中 提供 了 MODE WORLD READABLE 和 MODE 
WORLD_WRITEABLE 这 两 种 操作 模式 , 用 于 供给 其 他 的 应 用 程序 访问 当前 应 用 的 数据 , 但 这 两 
种 模式 在 Android 4.2 版 本 中 都 已 被 废弃 了 。 为 什么 呢 ? 因为 Android 官方 已 经 不 再 推荐 使 用 这 种 
方式 来 实现 跨 程序 数据 共享 的 功能 ， 而 是 应 该 使 用 更 加 安全 可 靠 的 内 容 提供 器 技术 。 

可 能 你 会 有 些 疑 惑 ， 为 什么 要 将 我 们 程序 中 的 数据 共享 给 其 他 程序 呢 ? 当然 ， 这 个 是 要 视 
情况 而 定 的 ， 比 如 说 账号 和 密码 这 样 的 隐私 数据 显然 是 不 能 共享 给 其 他 程序 的 ， 不 过 一 些 可 以 
让 其 他 程序 进行 二 次 开发 的 基础 性 数据 ， 我 们 还 是 可 以 选择 将 其 共享 的 。 例 如 系统 的 电话 短程 
序 ， 它 的 数据 库 中 保存 了 很 多 的 联系 人 信息 ， 如 果 这 些 数据 都 不 允许 第 三 方 的 程序 进行 访问 的 
话 ， 玖 怕 很 多 应 用 的 功能 都 要 大 打折 扣 了 。 除 了 电话 敌 之 外 ， 还 有 短信 、 媒 体 库 等 程序 都 实现 


了 路 程序 数据 共享 的 功能 ， 而 使 用 的 技术 当然 就 是 内 容 提供 器 了 ， 下 面 我 们 就 来 对 这 一 技术 进 
行 深入 的 探讨 。 


7.1 内 容 提 供 器 简介 

内 容 提 供 姻 ( Content Provider ) 主要 用 于 在 不 同 的 应 用 程序 之 间 实 现 数据 共享 的 功能 ， 它 提 
供 了 一 套 完 整 的 机 制 , 允许 一 个 程序 访问 另 一 个 程序 中 的 数据 , 同时 还 能 保证 被 访 数据 的 安全 性 。 
目前 ， 使 用 内 容 提供 器 是 Android 实现 跨 程序 共享 数据 的 标准 方式 。 

不 同 于 文件 存储 和 SharedPreferences 存储 中 的 两 种 全 局 可 读 写 操作 模式 , 内 容 提供 器 可 以 选 
择 只 对 哪 一 部 分 数据 进行 共享 ， 从 而 保证 我 们 程序 中 的 隐私 数据 不 会 有 泄漏 的 风险 。 

不 过 在 正式 开始 学 习 内 容 提 供 器 之 前 ， 我 们 需要 先 掌 握 另 外 一 个 非常 重要 的 知识 
Android 运行 时 权限 ， 因 为 待 会 的 内 容 提供 需 示 例 中 会 使 用 到 运行 时 权限 的 功能 。 当 然 不 光 是 


地 
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内 容 提供 器 ， 以 后 我 们 的 开发 过 程 中 也 会 经 常 使 用 到 运行 时 权限 ， 因 此 你 必须 能 够 牢 牢 掌握 它 
才 行 。 


7.2 ”运行 时 权限 


Android 的 权限 机 制 并 不 是 什么 新 鲜 事物 ， 从 系统 的 第 一 个 版 本 开始 就 已 经 存在 了 。 但 其 实 
之 前 Android 的 权限 机 制 在 保护 用 户 安全 和 隐私 等 方面 起 到 的 作用 比较 有 限 , 尤其 是 一 些 大 家 都 
离 不 开 的 常用 软件 ， 非 常 容 易 “ 店 大 其 客 "”。 为 此 ，Android 开发 团队 在 Android 6.0 系统 中 引用 
了 运行 时 权限 这 个 功能 , 从 而 更 好 地 保护 了 用 户 的 安全 和 隐私 , 那么 本 节 我 们 就 来 详细 学 习 一 下 
这 个 6.0 系统 中 引入 的 新 特性 。 


7.2.1 Android 权限 机 制 详解 


首先 来 回顾 一 下 过 去 Android 的 权限 机 制 是 什么 样 的 。 我 们 在 第 $ 章 写 BroadcastTest 项 目的 
时 候 第 一 次 接触 了 Android 权限 相关 的 内 容 , 当 时 为 了 要 访问 系统 的 网 络 状 态 以 及 监听 开机 广播 ， 
于 是 在 AndroidManifest.xml 文件 中 添加 了 这 样 两 句 权 限 声明 : 


<manifest xmlns:android="http://schemas.android.com/apk/res/android" 
package="com.example.broadcasttest"> 


<uses-permission android:name="android.permission.ACCESS NETWORK _ STATE" /> 
<uses-permission android:name="android.permission.RECEIVE BOOT COMPLETED" /> 


</manifest> 

为 访问 系统 的 网 络 状 态 以 及 监听 开机 广播 涉及 了 用 户 设备 的 安全 性 ， 因 此 必须 在 
AndroidManifest xml 中 加 入 权限 声明 ， 否 则 我 们 的 程序 就 会 月 演 。 

那么 现在 问题 来 了 , 加 入 了 这 两 名 权限 声 明 后 ,对 于 用 户 来 说 到 底 有 什么 影响 呢 ? 为 什么 这 
样 就 可 以 保护 用 户 设备 的 安全 性 了 呢 ? 
其 实用 户主 要 在 以 下 两 个 方面 得 到 了 保护 ， 一 方面 ， 如 果 用 户 在 低 于 6.0 系统 的 设备 上 安装 
该 程序 ， 会 在 安装 界面 给 出 如 图 7.1 所 示 的 提醒 。 这 样 用 户 就 可 以 清楚 地 知晓 该 程序 一 共 申 请 了 
哪些 权限 ， 从 而 决定 是 否 要 安装 这 个 程序 。 


共享 数据 一 一 探究 内 容 提供 器 


男 一 方面 ， 用 户 可 以 随时 在 应 用 程序 管理 界面 查看 任意 一 个 程序 的 权限 
所 示 。 这 样 该 程序 申请 的 所 有 权限 就 尽 收 眼底 ,什么 都 瞒 不 过 月 


会 出 现 各 种 滥用 权限 的 情况 。 


这 种 权限 机 制 的 设计 思路 其 实 非常 简单 ,就 
你 的 程序 ， 如 果 不 认 可 你 所 申请 的 权限 ， 那 么 


大 是 23:17 


BroadcastTest 


要 安装 此 应 用 吗 ? 它 将 获得 以 下 权限 : 
设备 相关 权限 


外 查看 网 络 连接 


回 ”开机 启动 
取消 安装 


图 7.1 安装 界面 的 权限 提醒 


请 情况 ， 如 图 7.2 
日 户 的 眼睛 ， 以 此 保证 应 用 程序 不 


缓存 0.00B 


默认 操作 


没有 默认 操作 


图 7.2 管理 界面 的 权限 展示 


i 是 用 户 如 果 认 可 你 所 申请 的 权限 , 那么 就 会 安装 
E 绝 安装 就 可 以 了 。 


但 是 理想 是 美好 的 ,现实 却 很 残酷 , 因为 很 多 我 们 所 离 不 开 的 常用 软件 普遍 存在 着 滥用 权限 
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的 情况 ， 不 管 到 底 用 不 用 得 到 ， 反 正 先 把 权限 申请 了 再 说 。 比 如 说 微 信 所 申请 的 权限 列表 如 图 
7.3 所 示 。 


\。 读 取 手 机 状态 和 身份 


周 ” 读 取 您 的 讯息 (短信 或 彩信 ) 


鲍 “拍摄 照片 和 视频 


:| 
人 体 传感器 (如 心跳 速率 检测 器 ) 


中 读 取 您 的 USB 存 储 设备 中 的 内 容 
修改 或 删除 您 的 USB 存 储 设备 中 的 内 容 


他 设置 亲 钟 


i le 


图 7.3 微 信 的 权限 列表 


这 只 是 微 信 所 申请 的 一 半 左 右 的 权限 , 因为 权限 太 多 一 屏 截 不 下 来 。 其 中 有 一 些 权 限 我 并 不 
认可 ,比如 微 信 为 什么 要 读 取 我 手机 的 短信 和 彩信 ? 但 是 我 不 认可 又 能 怎样 ,难道 我 拒绝 安装 微 
信 ? 没 错 ， 这 种 例子 比比 缘 是 ， 当 一 些 软件 已 经 让 我 们 产生 依赖 的 时 候 就 会 容易 “ 店 大 欺 客 ”， 
反正 这 个 权限 我 就 是 要 了 ， 你 自己 看 着 办 吧 

Android 开发 团队 当然 也 意识 到 了 这 个 问题 ， 于 是 在 6.0 系统 中 加 入 了 运行 时 权限 功能 。 也 
就 是 说 , 用 户 不 需要 在 安装 软件 的 时 候 一 次 性 授权 所 有 申请 的 权限 , 而 是 可 以 在 软件 的 使 用 过 程 
中 再 对 某 一 项 权限 申请 进行 授权 。 比 如 说 一 款 相 机 应 用 在 运行 时 申请 了 地 理 位 置 定位 权限 , 就算 
我 拒绝 了 这 个 权限 , 但 是 我 应 该 仍然 可 以 使 用 这 个 应 用 的 其 他 功能 , 而 不 是 像 之 前 那样 直接 无 法 


安装 它 。 
当然 , 并 不 是 所 有 权限 都 需要 在 运行 时 申请 , 对 于 用 户 来 说 , 不 停 地 授权 也 很 烦 珊 。Android 


现在 将 所 有 的 权限 归 成 了 两 类 ,一 类 是 普通 权限 ， 一 类 是 危险 权限 。 准 确 地 讲 ， 其 实 还 有 第 三 类 
特殊 权限 ,不 过 这 种 权限 使 用 得 很 少 ,因此 不 在 本 书 的 讨论 范围 之 内 。 普 通 权限 指 的 是 那些 不 会 
直接 威胁 到 用 户 的 安全 和 隐私 的 权限 ， 对 于 这 部 分 权限 申请 ， 系 统 会 自动 帮 我 们 进行 授权 ,而 不 
需要 用 户 再 去 手动 操作 了 ,比如 在 BroadcastTest 项 目 中 申请 的 两 个 权限 就 是 普通 权限 。 危险 权限 
则 表示 那些 可 能 会 触及 用 户 隐私 或 者 对 设备 安全 性 造成 影响 的 权限 ,如 获取 设备 联系 人 信息 、 定 
位 设备 的 地 理 位 置 等 ， 对 于 这 部 分 权限 申请 ,必须 要 由 用 户 手动 点 击 授权 才 可 以 ,否则 程序 就 无 
法 使 用 相应 的 功能 。 

但 是 Android 中 有 一 共有 上 百 种 权限 ， 我 们 怎么 从 中 区 分 哪些 是 普通 权限 ， 哪 些 是 危险 权限 
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呢 ? 其 实 并 没有 那么 难 ， 因 为 危险 权限 总 共 就 那么 几 个 , 除了 危险 权限 之 外 , 剩余 的 就 都 是 普通 
权限 了 。 下 表 列 出 了 Android 中 所 有 的 危险 权限 ， 一 共 是 9 组 24 个 权限 。 


权限 组 名 权限 名 
READ_CALENDAR 


CALENDAR 
WRITE CALENDAR 


CAMERA CAMERA 


READ CONTACTS 
CONTACTS WRITE CONTACTS 
GET_ACCOUNTS 
ACCESS FINE LOCATION 
ACCESS COARSE LOCATION 
MICROPHONE RECORD AUDIO 

READ PHONE STATE 

CALL PHONE 

READ CALL L0G 
PHONE WRITE CALL LOG 

ADD_ VOICEMAIL 

USE SIP 

PROCESS OUTGOING CALLS 
SENSORS BODY_SENSORS 

SEND_SMS 

RECEIVE_SMS 
SMS READ_SMS 

RECEIVE WAP_PUSH 

RECEIVE MMS 

READ EXTERNAL STORAGE 

WRITE EXTERNAL STORAGE 


这 张 表格 你 看 起 来 可 能 并 不 会 那么 轻松 , 因为 里 面 的 权限 全 都 是 你 没 使 用 过 的 。 不 过 没有 关 
系 , 你 并 不 需要 了 解 表格 中 每 个 权限 的 作用 ， 只 要 把 它 当 成 一 个 参照 表 来 查看 就 行 了 。 每 当 要 使 
用 一 个 权限 时 ,可 以 先 到 这 张 表 中 来 查 一 下 ， 如果 是 属于 这 张 表 中 的 权限 ,那么 就 需要 进行 运行 
时 权限 处 理 , 如 果 不 在 这 张 表 中 , 那么 只 需要 在 AndroidManifest.xml 文件 中 添加 一 下 权限 声明 就 
可 以 了 。 

另外 注意 一 下 , 表格 中 每 个 危险 权限 都 属于 一 个 权限 组 , 我 们 在 进行 运行 时 权限 处 理 时 使 用 
的 是 权限 名 , 但 是 用 户 一 旦 同意 授权 了 , 那么 该 权限 所 对 应 的 权限 组 中 所 有 的 其 他 权限 也 会 同时 
被 授权 。 

访问 http://developer.android.google.cn/reference/android/Manifest.permission.html 可 以 查看 
Android 系统 中 完整 的 权限 列表 。 


LOCATION 


STORAGE 
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好 了 , 关于 Android 权限 机 制 的 内 容 就 讲 这 么 多 ,理论 知识 你 已 经 了 解 得 非常 充足 了 。 接 下 
来 我 们 就 学 习 一 下 到 底 如 何在 程序 运行 的 时 候 申请 权限 。 


7.2.2 在 程序 运行 时 申请 权限 


首先 新 建 一 个 RuntimePermissionTest 项 目 , 我 们 就 在 这 个 项 目的 基础 上 来 学 习 运 行 时 权限 的 
使 用 方法 。 在 开始 动手 之 前 还 需要 考虑 一 下 到 底 要 申请 什么 权限 , 其 实 刚才 表 中 列 出 的 所 有 权限 
都 是 可 以 申请 的 ， 这 里 简单 起 见 我 们 就 使 用 CALL _PHONE 这 个 权限 来 作为 本 小 节 中 的 示例 吧 。 

CALL_PHONE 这 个 权限 是 编写 拨打 电话 功能 的 时 候 需 要 声明 的 ， 因 为 拨打 电话 会 涉及 用 户 手 
机 的 资费 问题 ， 因 而 被 列 为 了 危险 权限 。 在 Android 6.0 系统 出 现 之 前 ， 拨 打 电 话 功能 的 实现 其 
实 非常 简单 ， 修 改 activity_main.xml 布局 文件 ， 如 下 所 示 : 


<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:layout width="match parent" 
android:layout height="match parent"> 


<Button 
android:id="@+id/make call" 
android:layout width="match parent" 
android:layout height="wrap content" 
android:text="Make Call" /> 


</LinearLayout> 


我 们 在 布局 文件 中 只 是 定义 了 一 个 按钮 ， 当 点 击 按钮 时 就 去 触发 拨打 电话 的 逻辑 。 接 着 修改 
MainActivity 中 的 代码 ， 如 下 所 示 : 


public class MainActivity extends AppCompatActivity { 


@Override 
protected void onCreate(Bundle savedInstanceState) { 
super.onCreate(savedInstanceState); 
setContentView(R.layout.activity main); 
Button makeCall = (Button) findViewById(R.id.make call); 
makeCall.setOnClickListener(new View.0nCLickListener() { 
@Override 
public void onClick(View v) { 
try { 
Intent intent = new Intent(Intent.ACTION CALL); 
intent.setData(Uri.parse("tel:10086")); 
startActivity(intent); 
} catch (SecurityException e) { 
e.printStackTrace(); 
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可 以 看 到 ， 在 按钮 的 点 击 事件 中 ， 我 们 构建 了 一 个 隐 式 Intent ，Intent 的 action 指定 为 
Intent.ACTION_ CALL, 这 是 一 个 系统 内 置 的 打 电 话 的 动作 ,然后 在 data 部 分 指定 了 协议 是 tel， 
号 码 是 10086。 其 实 这 部 分 代码 我 们 在 2.3.3 小 节 中 就 已 经 见 过 了 ， 只 不 过 当时 指定 的 action 是 
Intent .ACTION_DIAL, 表示 打开 拨号 界面 ,这 个 是 不 需要 声明 权限 的 ,而 Intent.ACTION CALL 
则 可 以 直接 拨打 电话 ， 因 此 必须 声明 权限 。 男 外 为 了 防止 程序 崩 江 , 我 们 将 所 有 操作 都 放 在 了 异 
常 捕获 代码 块 当 中 。 

那么 接 下 来 修改 AndroidManifest xml 文件 ， 在 其 中 声明 如 下 权限 : 


<manifest xmlns:android="http://schemas.android.com/apk/res/android" 
package="com.example.runtimepermissiontest"> 


<uses-permission android:name="android.permission.CALL PHONE" /> 


<application 
android:allowBackup="true" 
android:icon="@mipmap/ic launcher" 
android:label="@string/app_name" 
android:supportsRtl="true" 
android:theme="@style/AppTheme"> 


</application> 
</manifest> 


这 样 我 们 就 将 拨打 电话 的 功能 成 功 实 现 了 ， 并 且 在 低 于 Android 6.0 系统 的 手机 上 都 是 可 以 
正常 运行 的 ， 但 是 如 果 我 们 在 6.0 或 者 更 高 版 本 系统 的 手机 上 和 运行， 点 击 Make Call 按钮 就 没有 
任何 效果 ， 这 时 观察 logcat 中 的 打印 日 志 ， 你 会 看 到 如 图 7.4 所 示 的 错误 信息 。 


java. lang. SecurityException: Permission Denial: starting Intent { act=android. intent. action. CALL 


at android. os. Parcel. readException(Parcel. java:1599) 

at android. os. Parcel. readException (Parce ara :1552 

at android. app. ActivityManagerProxy. startActivity (ActivityManagerNative. java:2658) 
at android. app. Instrumentation. execStartActivity( 工 ent F ) 

at android. app. Activity. startActivityForResult (4 39 

at android. app. Activity. startActivityForResult ( J 3877) 

at android. support. v4. app. FragmentActivity. startActivityForResult (FrasmentActivit; :843) 
at android. app. Activity. startActivity (4etiv ava: 4 

at android. app. Activity. startActivity (detivity. java:4169) 


at com. example. runtimepermissiontest. MainActivity$1. onClick (Maindctivity. java:29 
图 7.4 错误 日 志 信 息 
错误 信息 中 提醒 我 们 “Permission Denial”, 可 以 看 出 , 是 由 于 权限 被 禁止 所 导致 的 , 因为 6.0 
及 以 上 系统 在 使 用 危险 权限 时 都 必须 进行 运行 时 权限 处 理 。 
那么 下 面 我 们 就 来 尝试 修复 这 个 问题 ， 修 改 MainActivity 中 的 代码 ， 如 下 所 示 : 


public class MainActivity extends AppCompatActivity { 


@Override 


7.2 ”运行 时 权限 251 


protected void onCreate(Bundle savedInstanceState) { 
super.onCreate(savedInstanceState); 
setContentView(R.layout.activity main); 
Button makeCall = (Button) findViewById(R.id.make call); 
makeCall.setOnClickListener(new View.0nCLickListener() { 
@Override 
public void onClick(View v) { 
if (ContextCompat.checkSelfPermission(MainActivity.this, Manifest. 
permission.CALL PHONE) != PackageManager.PERMISSION GRANTED) { 
ActivityCompat. requestPermissions (MainActivity.this, new 
String[]{ Manifest.permission.CALL PHONE }, 1); 
} else{ 
call(); 
} 


}); 
} 


private void call() { 
try { 
Intent intent = new Intent(Intent.ACTION CALL); 
intent.setData(Uri.parse("tel:10086")); 
startActivity(intent); 
} catch (SecurityException e) { 
e.printStackTrace(); 
} 
} 


@Override 
public void onRequestPermissionsResult(int requestCode, String[] permissions, 
int[] grantResults) { 
switch (requestCode) { 
case 1: 
if (grantResuLts.Length > 0 && grantResuLts[0] == PackageManager. 
PERMISSION GRANTED) { 
call(); 
} else{ 
Toast.makeText(this, "You denied the permission", Toast.LENGTH_ 
SHORT) .show(); 
} 
break; 
default: 


} 

上 面 的 代码 将 运行 时 权限 的 完整 流程 都 覆盖 了 ， 下 面 我 们 来 具体 解析 一 下 。 说 白 了 ,运行 时 
权限 的 核心 就 是 在 程序 运行 过 程 中 由 用 户 授权 我 们 去 执行 某 些 危险 操作 , 程序 是 不 可 以 擅自 做 主 
去 执行 这 些 危 险 操作 的 。 因 此 , 第 一 步 就 是 要 先 判断 用 户 是 不 是 已 经 给 过 我 们 授权 了 , 借助 的 是 
ContextCompat.checkSelfPermission() 方 法 。checkSelfPermission() 方 法 接收 两 个 参数 ， 
第 一 个 参数 是 Context,， 这 个 没什么 好 说 的 , 第 二 个 参数 是 具体 的 权限 名 ， 比 如 打 电 话 的 权限 名 


i 
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就 是 Manifest.permission.CALL_PHONE， 然 后 我 们 使 用 方法 的 返回 值 和 PackageManager. 
PERMISSION_GRANTED 做 比较 ， 相 等 就 说 明 用 户 已 经 授权 ， 不 等 就 表示 用 户 没有 授权 。 

如 果 已 经 授权 的 话 就 简单 了 , 直接 去 执行 拨打 电话 的 逻辑 操作 就 可 以 了 , 这 里 我 们 把 拨打 电 
话 的 逻辑 封装 到 了 call() 方 法 当中 。 如 果 没 有 授权 的 话 ， 则 需要 调用 ActivityCompat , 
requestPermissions() 方 法 来 向 用 户 申请 授权 ，requestPermissions() 方 法 接收 3 个 参数 ， 
第 一 个 参数 要 求 是 Activity 的 实例 ， 第 二 个 参数 是 一 个 String 数组 ， 我 们 把 要 申请 的 权限 名 放 
在 数组 中 即 可 ， 第 三 个 参数 是 请 求 码 ， 只 要 是 唯一 值 就 可 以 了 ， 这 里 传人 了 1。 

调用 完了 requestPermissions() 方 法 之 后 , 系统 会 弹出 一 个 权限 申请 的 对 话 框 , 然后 用 户 
可 以 选择 同意 或 拒绝 我 们 的 权限 申请 ,不论 是 哪 种 结果 ， 最 终 都 会 回调 到 onRequest- 
PermissionsResult() 方 法 中 ,而 授权 的 结果 则 会 封装 在 grantResults 参数 当中 。 这 里 我 们 
只 需要 判断 一 下 最 后 的 授权 结果 ， 如 果 用 户 同 意 的 话 就 调用 call() 方 法 来 拨打 电话 ， 如 果 用 户 
拒绝 的 话 我 们 只 能 放弃 操作 ， 并 且 弹 出 一 条 失败 提示 。 

现在 重新 运行 一 下 程序 ， 并 点 击 Make Call 按钮 ， 效 果 如 图 7.5 所 示 。 

由 于 用 户 还 没有 授权 过 我 们 拨打 电话 权限 , 因此 第 一 次 运行 会 弹出 这 样 一 个 权限 申请 的 对 话 
框 ， 用 户 可 以 选择 同意 或 者 拒绝 ， 比 如 说 这 里 点 击 了 DENY， 结果 如 图 7.6 所 示 。 


i B 3:35 


RuntimePermissionTest 


MAKE CALL 


图 7.5 申请 电话 权限 对 话 框 图 7.6 用 户 拒绝 了 权限 申请 


由 于 用 户 没有 同意 授权 ， 我 们 只 能 弹出 一 个 操作 失败 的 提示 。 下 面 我 们 再 次 点 击 Make Call 
按钮 ， 仍 然 会 弹出 权限 申请 的 对 话 框 ， 这 次 点 击 ALLOW ， 结 果 如 图 7.7 所 示 。 


出 | 
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图 7.7 拨打 


电话 界面 


可 以 看 到 ， 这 次 我 们 就 成 功 进入 到 拨打 电话 界面 了 ,并 且 由 于 用 户 已 经 完成 了 授权 操作 ,之 
后 再 点 击 Make Call 按钮 就 不 会 再 弹出 权限 申请 对 话 框 了 ， 而 是 可 以 直接 拨打 电话 。 那 可 能 你 会 
担心 ,万 一 以 后 我 又 后 悔 了 怎么 办 ?没有 关系 ,用 户 随 时 都 可 以 将 授予 程序 的 危险 权限 进行 关闭 ， 
进入 Settings 一 Apps 一 RuntimePermissionTest 一 Permissions， 界 面 如 图 7.8 所 示 。 


€ Apppermissions 


RuntimePermissionTest 


图 7.8 


4 


应 用 


[© 口 


程序 权限 管 型 


界面 


在 这 里 我 们 就 可 以 对 任何 授予 过 的 危险 权限 进行 关闭 了 。 
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好 了 , 关于 运行 时 权限 的 内 容 就 讲 到 这 里 ， 现 在 你 已 经 有 能 力 处 理 Android 上 各 种 关于 权限 
的 问题 了 ， 下 面 我 们 就 来 进入 本 章 的 正题 一 一 内 容 提供 需 。 


7.3 访问 其 他 程序 中 的 数据 


内 容 提供 器 的 用 法 一 般 有 两 种 , 一 种 是 使 用 现 有 的 内 容 提供 器 来 读 取 和 操作 相应 程序 中 的 数 
据 ,， 另 一 种 是 创建 自己 的 内 容 提 供 器 给 我 们 程序 的 数据 提供 外 部 访问 接口 。 那 么 接 下 来 我 们 就 一 
个 一 个 开始 学 习 吧 ， 首 先 从 使 用 现 有 的 内 容 提 供 器 开始 。 

如 果 一 个 应 用 程序 通过 内 容 提 供需 对 其 数据 提供 了 外 部 访问 接口 , 那么 任何 其 他 的 应 用 程序 
就 都 可 以 对 这 部 分 数据 进行 访问 。Android 系统 中 自 带 的 电话 矫 、 短 信 、 媒 体 库 等 程序 都 提供 了 
类 似 的 访问 接口 , 这 就 使 得 第 三 方 应 用 程序 可 以 充分 地 利用 这 部 分 数据 来 实现 更 好 的 功能 。 下 面 
我 们 就 来 看 一 看 ， 内 容 提 供 器 到 底 是 如 何 使 用 的 。 


7.3.1 ContentResolver 的 基本 用 法 


对 于 每 一 个 应 用 程序 来 说 ， 如 果 想 要 访问 内 容 提供 器 中 共享 的 数据 ， 就 一 定 要 借助 Content- 
Resolver 类 ， 可 以 通过 Context 中 的 getContentResolver() 方 法 获取 到 该 类 的 实例 。Content- 
Resolver 中 提供 了 一 系列 的 方法 用 于 对 数据 进行 CRUD 操作 , 其 中 insert() 方 法 用 于 添加 数据 ， 
update() 方 法 用 于 更 新 数据 ，delete() 方 法 用 于 删除 数据 ，query() 方 法 用 于 查询 数据 。 有 没 
有 似曾相识 的 感觉 ? 没 错 ，SQLiteDatabase 中 也 是 使 用 这 几 个 方法 来 进行 CRUD 操作 的 , 只 不 过 
它们 在 方法 参数 上 稍微 有 一 些 区 别 。 

不 同 于 SQLiteDatabase，ContentResolver 中 的 增删 改 查 方法 都 是 不 接收 表 名 参数 的 ， 而 是 使 
用 一 个 Uri 参数 代替 ， 这 个 参数 被 称 为 内 容 URI。 内 容 URI 给 内 容 提供 器 中 的 数据 建立 了 唯 
标识 符 ， 它 主要 由 两 部 分 组 成 : authority 和 path。authority 是 用 于 对 不 同 的 应 用 程序 做 区 分 的 ， 
一 般 为 了 避免 冲突 ， 都 会 采用 程序 包 名 的 方式 来 进行 命名 。 比 如 某 个 程序 的 包 名 是 com.example. 
app， 那 么 该 程序 对 应 的 authority 就 可 以 命名 为 com.example.app. provider。path 则 是 用 于 对 同一 
应 用 程序 中 不 同 的 表 做 区 分 的 , 通常 都 会 添加 到 authority 的 后 面 。 比 如 某 个 程序 的 数据 库 里 存在 
两 张 表 : tablel 和 table2, 这 时 就 可 以 将 path 分 别 命名 为 /tablel 和 /table2, 然后 把 authority 和 path 
进行 组 合 , 内 容 URI 就 变 成 了 com.example.app.provider/tablel 和 com.example.app.providertable2 。 
不 过 , 目前 还 很 难 辨认 出 这 两 个 字符 串 就 是 两 个 内 容 URI, 我 们 还 需要 在 字符 串 的 头 部 加 上 协议 
声明 。 因 此 ， 内 容 URI 最 标准 的 格式 写法 如 下 : 


content://com.example.app.provider/tablel 

content://com.example.app.provider/table2 

有 没有 发 现 ， 内 容 URI 可 以 非常 清楚 地 表达 出 我 们 想 要 访问 哪个 程序 中 哪 张 表 里 的 数据 。 
也 正 是 因此 , ContentResolver 中 的 增删 改 查 方法 才 都 接收 Uri 对 象 作 为 参数 , 因为 如 果 使 用 表 名 
的 话 ， 系 统 将 无 法 得 知 我 们 期 望 访问 的 是 哪个 应 用 程序 里 的 表 。 
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在 得 到 了 内 容 URI 字符 串 之 后 ， 我 们 还 需要 将 它 解 析 成 Uri 对 象 才 可 以 作为 参数 传人 。 解 
析 的 方法 也 相当 简单 ， 代 码 如 下 所 示 : 


Uri uri = Uri.parse("content://com.example.app.provider/tablel") 
只 需要 调用 Uri.parse() 方 法 ,就 可 以 将 内 容 URI 字 符 串 解析 成 Uri 对 象 了 。 
现在 我 们 就 可 以 使 用 这 个 Uri 对 象 来 查询 tablel 表 中 的 数据 了 ， 代 码 如 下 所 示 : 


Cursor cursor = getContentResolver().query( 
uri, 
projection, 
selection, 
selectionArgs, 
sortOrder); 


这 些 参数 和 SQLiteDatabase 中 query() 方 法 里 的 参数 很 像 , 但 总 体 来 说 要 简单 一 些 , 毕竟 i 
是 在 访问 其 他 程序 中 的 数据 , 没 必 要 构建 过 于 复杂 的 查询 语句 。 下 表 对 使 用 到 的 这 部 分 参数 进 
了 详细 的 解释 。 


这 
行 


query() 方 法 参数 对 应 SQL 部 分 描 述 
uri from table name 指定 查询 某 个 应 用 程序 下 的 某 一 张 表 
projection select coLumn1，coLumn2 间 定 查询 的 列 名 
selection where column = value 指定 where 的 约束 条 件 
selectionArgs 为 where 中 的 占 位 符 提供 具体 的 值 
sortOrder order by columnl, column2 指定 查询 结果 的 排序 方式 


查询 完成 后 返回 的 仍然 是 一 个 Cursor 对 象 ， 这 时 我 们 就 可 以 将 数据 从 Cursor 对 象 中 逐个 
读 取出 来 了 。 读 取 的 思路 仍然 是 通过 移动 游标 的 位 置 来 遍历 Cursor 的 所 有 行 ， 然 后 再 取出 每 一 
行 中 相应 列 的 数据 ， 代 码 如 下 所 示 : 
if (cursor != null) { 
while (cursor.moveToNext()) { 


String coLumn1l = cursor.getString(cursor.getColumnIndex("column1")); 
int column2 = cursor.getInt(cursor.getColumnIndex("column2")); 


} 
cursor.close(); 


} 


掌握 了 最 难 的 查询 操作 ,， 剩 下 的 增加 、 修 改 、 删 除 操作 就 更 不 在 话 下 了 。 我们 先 来 看 看 如 何 
向 tablel 表 中 添加 一 条 数据 ， 代 码 如 下 所 示 : 


ContentValues values = new ContentValues(); 
values.put("column1l", "text"); 
values.put("column2", 1); 
getContentResolver().insert(uri, values); 


可 以 看 到 ,仍然 是 将 待 添加 的 数据 组 装 到 ContentValues 中 ， 然 后 调用 ContentResolver 的 
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insert() 方 法 , 将 Uri 和 ContentValues 作为 参数 传人 即 可 。 


现在 如 果 我 们 想 要 更 新 这 条 新 添加 的 数据 , 把 column1 的 值 清空 ， 可 以 借助 ContentResolver 
的 update( ) 方 法 实现 ， 代 码 如 下 所 示 : 

ContentValues values = new ContentValues(); 

values.put("column1l", ""); 


getContentResolver().update(uri, values, "columnl = ? and coLumn2 = ?", new 
String[] {"text", "1"}); 


注意 上 述 代码 使 用 了 selection 和 selectionArgs 参数 来 对 想 要 更 新 的 数据 进行 约束 , 以 
防止 所 有 的 行 都 会 受 影响 。 

最 后 ， 可 以 调用 ContentResolver 的 detLete ( ) 方 法 将 这 条 数据 删除 掉 ， 代 码 如 下 所 示 : 

getContentResolver().delete(uri, "column2 = ?", new String[] { "1" }); 

到 这 里 为 止 ， 我 们 就 把 ContentResolver 中 的 增删 改 查 方法 全 部 学 完了 。 是 不 是 感觉 一 看 就 
昔 ? 因为 这 些 知识 早 在 上 一 章 中 学 习 SQLiteDatabase 的 时 候 你 就 已 经 掌握 了 , 所 需 特别 注意 的 就 
只 有 uri 这 个 参数 而 已 。 那么 接 下 来 , 我 们 就 利用 目前 所 学 的 知识 , 看 一 看 如 何 读 取 系 统 电话 笑 
中 的 联系 人 信息 。 


7.3.2” 读 取 系 统 联 系 人 


由 于 我 们 之 前 一 直 使 用 的 都 是 模拟 器 , 电话 短 里 面 并 没有 联系 人 存在 , 所 以 现在 需要 自己 手 
动 添加 几 个 ， 以 便 稍 后 进行 读 取 。 打 开 电 话 短程 序 ， 界 面 如 图 7.9 所 示 。 


Ca 


本 oO 口 


图 7.9 ”电话 薄 程 序 主 界 国 
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可 以 看 到 ， 目 前 电话 短 里 是 没有 任何 联系 人 的 ， 我 们 可 以 通过 点 击 ADD A CONTACT 按钮 
来 对 联系 人 进行 创建 。 这 里 就 先 创建 两 个 联系 人 吧 ， 分别 填 和 人 他们 的 姓名 和 手机 号 ， 如 图 7.10 
所 示 。 


Add new contact 


和 Tom 人 John 


\ 1234-567-890| \。 (098) 765-4321 


More Fields More Fields 


4 O | | O 〇 口 
图 7.10 ”添加 两 个 联系 人 
这 样 准备 工作 就 做 好 了 ， 现 在 新 建 一 个 ContactsTest 项 目 ， 让 我 们 开始 动手 吧 。 
首先 还 是 来 编写 一 下 布局 文件 ， 这 里 我 们 和 希望 读 取出 来 的 联系 人 信息 能 够 在 ListView 中 显 
示 ， 因 此 ， 修 改 activity_main.xml 中 的 代码 ， 如 下 所 示 : 
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:orientation="vertical" 


android:layout width="match parent" 
android:layout height="match parent" > 


<ListView 
android:id="@+id/contacts view" 
android:layout width="match parent" 
android:layout height="match parent" > 
</ListView> 


</LinearLayout> 


简单 起 见 ,LinearLayout 里 就 只 放置 了 一 个 ListView。 这 里 使 用 ListView 而 不 是 RecyclerView， 
是 因为 我 们 要 将 关注 的 重点 放 在 读 取 系统 联系 人 人 上面， 如果 使 用 RecyclerView 的 话 ， 代 码 偏 多 ， 
会 容易 让 我 们 找 不 着 重点 。 


接着 修改 MainActivity 中 的 代码 ， 如 下 所 示 : 
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public class MainActivity extends AppCompatActivity { 
ArrayAdapter<String> adapter; 
List<String> contactsList = new ArrayList<>(); 


@Override 
protected void onCreate(Bundle savedInstanceState) { 
super.onCreate(savedInstanceState); 
setContentView(R.layout.activity main); 
ListView contactsView = (ListView) findViewById(R.id.contacts view); 
adapter = new ArrayAdapter<String>(this, android.R.layout. simple List 
item 1, contactsList); 
contactsView.setAdapter(adapter); 
if (ContextCompat,.checkSelfPermission(this, Manifest.permission.READ 
CONTACTS) != PackageManager.PERMISSION GRANTED) { 
ActivityCompat.requestPermissions(this, new String[]{ Manifest. 
permission.READ CONTACTS }, 1); 
} else { 
readContacts () ; 
} 
} 


private void readContacts() { 
Cursor cursor = null; 
try { 
// 查询 联系 人 数据 
cursor = getContentResolver().query(ContactsContract.CommonDataKinds. 
Phone.CONTENT URI, null, null, null, null); 
if (cursor != null) { 
while (cursor.moveToNext()) { 
// 获取 联系 人 姓名 
String displayName = cursor.getString(cursor.getColumnIndex 
(ContactsContract.CommonDataKinds.Phone.DISPLAY NAME)); 
// 获取 联系 人 手机 号 
String number = cursor.getString(cursor.getColumnIndex 
(ContactsContract .CommonDataKkinds .Phone.NUMBER) ) ; 
contactsList.add(displayName + "\n" + number); 
} 
adapter.notifyDataSetChanged(); 
} 
} catch (Exception e) { 
e.printStackTrace(); 
} finally { 
if (cursor != null) { 
cursor.close(); 


} 
} 


@Override 

public void onRequestPermissionsResult(int requestCode, String[] permissions, 
int[] grantResults) { 
switch (requestCode) { 
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case 1: 
if (grantResults.length > 0 && grantResults[0] == PackageManager. 
PERMISSION GRANTED) { 
readContacts(); 
} else { 
Toast.makeText(this, "You denied the permission"，Toast.LENGTH 
SHORT) .show( ) ; 
} 
break; 
default: 


} 


在 onCreate() 方 法 中 , 我们 首先 获取 了 ListView 控件 的 实例 ， 并 给 它 设置 好 了 适配器 ， 然 
后 开始 调用 运行 时 权限 的 处 理 逻 辑 ,， 因为 READ_ CONTACTS 权限 是 属于 危险 权限 的 。 关 于 运行 
时 权限 的 处 理 流程 相信 你 已 经 熟练 掌握 了 , 这 里 我 们 在 用 户 授权 之 后 调用 readContacts () 方 法 
来 读 取 系 统 联系 人 信息 。 


下 面 重点 看 一 下 readContacts () 方 法 , 可 以 看 到 , 这 里 使 用 了 ContentResolver 的 query () 
方法 来 查询 系统 的 联系 人 数据 。 不 过 传人 的 Uri 参数 怎么 有 些 奇怪 啊 ” 为 什么 没有 调用 
Uri.parse() 方 法 去 解析 一 个 内 容 URI 字 符 串 呢 ? 这 是 因为 ContactsContract .CommonData- 
Kinds .Phone 类 已 经 帮 有 我们 做 好 了 封装 ， 提 供 了 一 个 CONTENT_URI 常量 ， 而 这 个 常量 就 是 使 用 
Uri.parse() 方 法 解析 出 来 的 结果 。 接 着 我 们 对 Cursor 对 象 进行 遍历 ， 将 联系 人 姓名 和 手机 号 
这 些 数据 逐个 取出 ， 联 系 人 姓名 这 一 列 对 应 的 常量 是 ContactsContract.CommonDataKinds. 
Phone.DISPLAY_NAME ， 联 系 人 手机 号 这 一 列 对 应 的 常量 是 ContactsContract.CommonData- 
Kinds .Phone.NUMBER。 两 个 数据 都 取出 之 后 ， 将 它们 进行 拼接 ， 并 且 在 中 间 加 上 换行 符 ， 然 后 
将 拼接 后 的 数据 添加 到 ListView 的 数据 源 里 ， 并 通知 刷新 一 下 ListView。 最 后 千 万 不 要 忘记 将 
Cursor 对 象 关闭 掉 。 

这 样 就 结束 了 吗 ? 还 差 一 点 点 ， 读 取 系 统 联系 人 的 权限 千 万 不 能 忘记 声明 。 修 改 
AndroidManifest.xml 中 的 代码 ， 如 下 所 示 : 


<manifest xmlns:android="http://schemas.android.com/apk/res/android" 
package="com.example.contactstest"> 


<uses-permission android:name="android.permission.READ_ CONTACTS" /> 
</manifest> 


加 入 了 android.permission.READ CONTACTS 权限 , 这 样 我 们 的 程序 就 可 以 访问 到 系统 的 
联系 人 数据 了 。 现 在 才 算是 大 功 告 成 了 ， 让 我 们 来 运行 一 下 程序 吧 ， 效 果 如 图 7.11 所 示 。 
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加 Allow ContactsTest to 
一 ”access yo ? 


图 7.11 申请 访问 联系 人 权限 对 话 框 
首先 弹出 了 申请 访问 联系 人 权限 的 对 话 框 ,我 们 点 击 ALLOW ， 然 后 结果 如 图 7.12 所 示 。 
ContactsTest ne 
1 765-4321 
4 O 口 


图 7.12 ”展示 系统 联系 人 信 ， 


刚刚 添加 的 两 个 联系 人 的 数据 都 成 功 读 取出 来 了 ! 这 说 明 跨 程序 访问 数据 的 功能 确实 是 实 
现 了 。 


7.4 创建 自己 的 内 容 提供 器 
在 上 一 节 当中 , 我 们 学 习 了 如 何在 自己 的 程序 中 访问 其 他 应 用 程序 的 数据 。 总 体 来 说 思路 还 


斌 
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是 非常 简单 的 ， 只 需要 获取 到 该 应 用 程序 的 内 容 URI， 然 后 借助 ContentResolver 进行 CRUD 操 
作 就 可 以 了 。 可 是 你 有 没有 想 过 ， 那 些 提供 外 部 访问 接口 的 应 用 程序 都 是 如 何 实现 这 种 功能 的 


呢 ? 它 们 又 是 怎样 保 订 


疑惑 将 会 被 一 一 解 开 。 


7.4.1 


创建 内 容 提供 器 的 步骤 
前 面 已 经 提 到 过 , 如 果 想 要 实现 跨 程序 共享 数据 的 功能 ,官方 推荐 的 方式 就 是 使 用 内 容 提供 


[数据 的 安全 性 , 使 得 隐私 数据 不 会 泄漏 出 去 ? 学 习 完 本 节 的 知识 后 , 你 的 


器 ， 可 以 通过 新 建 一 个 类 去 继承 ContentProvider 的 方式 来 创建 一 个 自己 的 内 容 提 供 器 。 


ContentProvider 类 中 有 6 个 抽象 方法 ， 我 们 在 使 用 


子 类 继承 它 的 时 候 ， 需 要 将 这 6 个 方法 全 


部 重 写 。 新 建 MyProvider 继承 自 ContentProvider， 代 人 码 如 下 所 示 : 


public class MyProvider extends ContentProvider { 


} 


在 这 6 个 方法 中 ， 相 信 大 多 数 你 都 已 经 非常 熟悉 了 ， 我 再 来 简单 介绍 一 下 吧 。 


GOverride 


public boolean onCreate() { 


return false; 


} 


GOverride 


public Cursor query(Uri uri, String[] projection, String selection, String[] 


selectionArgs, String sortOrder) { 


return null; 


} 


GOverride 


public Uri insert(Uri uri, ContentValues values) { 


return null; 


} 


@Override 


public int update(Uri uri, ContentValues values, String selection, String[] 


selectionArgs) { 
return 0; 


} 


GOverride 


public int delete(Uri uri, String selection, String[] selectionArgs) { 


return 0; 


} 


GOverride 


public String getType(Uri uri) { 


return null; 


} 
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1. onCreate() 

初始 化 内 容 提 供 器 的 时 候 调 用 。 通 常会 在 这 里 完成 对 数据 库 的 创建 和 升级 等 操作 , 返回 true 
表示 内 容 提供 需 初 始 化 成 功 ， 返 回 false 则 表示 失败 。 

2. query() 

从 内 容 提供 器 中 查询 数据 。 使 用 uri 参数 来 确定 查询 哪 张 表 ，projection 参数 用 于 确定 查 
询 哪些 列 ，selection 和 selectionArgs 参数 用 于 约束 查询 哪些 行 ，sort0rder 参数 用 于 对 结 
果 进 行 排序 ， 查 询 的 结果 存放 在 Cursor 对 象 中 返回 。 

3. insert() 

向 内 容 提供 器 中 添加 一 条 数据 。 使 用 uri 参数 来 确定 要 添加 到 的 表 ， 待 添加 的 数据 保存 在 
values 参数 中 。 添 加 完成 后 ， 返 回 一 个 用 于 表示 这 条 新 记录 的 URI。 

4. update() 

更 新 内 容 提供 器 中 已 有 的 数据 。 使 用 uri 参数 来 确定 更 新 哪 一 张 表 中 的 数据 , 新 数据 保存 在 
values 参数 中 ，selection 和 selectionArgs 参数 用 于 约束 更 新 哪些 行 ， 受 影响 的 行 数 将 作 
为 返回 值 返 回 。 

5. delete() 

从 内 容 提供 器 中 删除 数据 。 使 用 uri 参数 来 确定 删除 哪 一 张 表 中 的 数据 ，selection 和 
selectionArgs 参数 用 于 约束 删除 哪些 行 ， 被 删除 的 行 数 将 作为 返回 值 返 回 。 

6. getType() 

根据 传人 的 内 容 URI 来 返回 相应 的 MIME 类 型 。 

可 以 看 到 ， 几 乎 每 一 个 方法 都 会 带 有 Uri 这 个 参数 ， 这 个 参数 也 正 是 调用 ContentResolver 
的 增删 改 查 方法 时 传递 过 来 的 。 而 现在 , 我 们 需要 对 传人 的 Uri 参数 进行 解析 ,从 中 分 析出 调用 
方 期 望 访问 的 表 和 数据 。 

回顾 一 下 ， 一 个 标准 的 内 容 URI 写法 是 这 样 的 : 

content://com.example.app.provider/tablel 

这 就 表示 调用 方 期 望 访问 的 是 com.example.app 这 个 应 用 的 tablel 表 中 的 数据 。 除 此 之 外 ， 
我 们 还 可 以 在 这 个 内 容 URI 的 后 面 加 上 一 个 i 4， 如 下 所 示 : 

content://com.example.app.provider/tablel/1 

这 就 表示 调用 方 期 望 访问 的 是 com.example.app 这 个 应 用 的 tablel 表 中 id 为 1 的 数据 。 

内 容 URI 的 格式 主要 就 只 有 以 上 两 种 ， 以 路 径 结尾 就 表示 期 望 访 问 该 表 中 所 有 的 数据 ， 以 
id 结尾 就 表示 期 望 访 问 该 表 中 拥有 相应 id 的 数据 。 我 们 可 以 使 用 通配符 的 方式 来 分 别 匹配 这 两 
种 格式 的 内 容 URI， 规 则 如 下 。 
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中 提供 了 一 


口 *: 表示 匹配 任意 长 度 的 任意 字符 。 
口 #: 表示 匹配 任意 长 度 的 数字 。 
所 以 ， 一 个 能 够 匹配 任意 表 的 内 容 URI 格 式 就 可 以 写成 : 


content://com.example.app.provider/* 


而 一 个 能 够 匹配 tablel 表 中 任意 一 行 数据 的 内 容 URI 格 式 就 可 以 写成 : 


content://com.example.app.provider/tablel/# 


接着 ， 我 们 再 借助 UriMatcher 这 个 类 就 可 以 轻松 地 实现 匹配 内 容 URI 的 功能 。UriMatcher 


个 addURI() 方 法 , 这 个 方法 接收 3 个 参数 , 可 以 分 别 把 authority 、path 和 一 个 自 


定义 代码 传 进去 。 这 样 ， 当 调用 UriMatcher 的 match() 方 法 时 ， 就 可 以 将 一 个 Uri 对 象 传人 ， 
返回 值 是 某 个 能 够 匹配 这 个 Uri 对 象 所 对 应 的 自 定义 代码 , 利用 这 个 代码 , 我 们 就 可 以 判断 出 调 


月 


方 


期 望 访问 的 是 哪 张 表 中 的 数据 了 。 修 改 MyProvider 中 的 代码 ， 如 下 所 示 : 


public class MyProvider extends ContentProvider { 


public static final int TABLE]1 DIR = 0; 
public static finaL int TABLE1_ITEM = 1; 
public static final int TABLE2 DIR = 2; 
public static final int TABLE2 ITEM = 3; 
private static UriMatcher uriMatcher; 
static { 


uriMatcher = new UriMatcher(UriMatcher.NO MATCH); 
uriMatcher.addURI("com.example.app.provider", "tablel", TABLE] DIR); 


uriMatcher.addURI("com.example.app.provider ", "tablel/#", TABLE]1 ITEM); 


uriMatcher.addURI("com.example.app.provider ", "table2", TABLE2 DIR); 


uriMatcher.addURI("com.example.app.provider ", "table2/#", TABLE2 ITEM); 


GOverride 


public Cursor query(Uri uri, String[] projection, String selection, String[] 


selectionArgs, String sortOrder) { 
switch (uriMatcher.match(uri)) { 
case TABLE1_DIR: 
// 查询 tablel 表 中 的 所 有 数据 
break; 
case TABLE1_ITEM : 
// 查询 tabLel 表 中 的 单条 数据 
break 
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case TABLE2_DIR: 
// 查询 table2 表 中 的 所 有 数据 
break; 

case TABLE2 _ ITEM: 
// 查询 table2 表 中 的 单条 数据 
break; 

default: 
break; 

} 


} 


可 以 看 到 ，MyProvider 中 新 增 了 4 个 整 型 常量 ， 其 中 TABLE1_DIR 表示 访问 tablel 表 中 的 所 
有 数据 ，TABLE1_ITEM 表示 访问 tablel 表 中 的 单条 数据 ，TABLE2_DIR 表示 访问 table2 表 中 的 所 
有 数据 ，TABLE2_ITEM 表示 访问 table2 表 中 的 单条 数据 。 接 着 在 静态 代码 块 里 我 们 创建 了 
UriMatcher 的 实例 ， 并 调用 addURI() 方 法 ,将 期 望 匹配 的 内 容 URI 格 式 传递 进去 ， 注 意 这 里 传 
入 的 路 径 参数 是 可 以 使 用 通配符 的 。 然 后 当 query() 方 法 被 调用 的 时 候 ， 就 会 通过 UriMatcher 
的 match() 方 法 对 传 入 的 Uri 对 象 进行 匹配 ， 如 果 发 现 UriMatcher 中 某 个 内 容 URI 格 式 成 功 匹 
配 了 该 Uri 对 象 , 则 会 返回 相应 的 自 定义 代码 , 然后 我 们 就 可 以 判断 出 调用 方 期 望 访问 的 到 底 是 
什么 数据 了 。 

上 述 代码 只 是 以 query() 方 法 为 例 做 了 个 示范 ， 其 实 insert() 、update() 、detete() 这 
几 个 方法 的 实现 也 是 差不多 的 ,它们 都 会 携带 Uri 这 个 参数 ,然后 同样 利用 UriMatcher 的 match() 
方法 判断 出 调用 方 期 望 访问 的 是 哪 张 表 ， 再 对 该 表 中 的 数据 进行 相应 的 操作 就 可 以 了 。 

除 此 之 外 , 还 有 一 个 方法 你 会 比较 陌生 , 即 getType() 方 法 。 它 是 所 有 的 内 容 提 供需 都 必须 
提供 的 一 个 方法 ， 用 于 获取 Uri 对 象 所 对 应 的 MIME 类 型 。 一 个 内 容 URI 所 对 应 的 MIME 字符 
串 主要 由 3 部 分 组 成 ，Android 对 这 3 个 部 分 做 了 如 下 格式 规定 。 

口 必须 以 vnd 开头 。 

口 如 果 内 容 URI 以 路 径 结尾 ， 则 后 接 android.cursor.dir/， 如 果 内 容 URI 以 id 结尾 ， 
则 后 接 android.cursor.item/。 

口 最 后 接 上 vnd.<authority>.<path>。 


所 以 ， 对 于 content://com.example.app.provider/tablel 这 个 内 容 URI， 它 所 对 应 的 MIME 类 型 
就 可 以 写成 : 


vnd.android.cursor.dir/vnd.com.example.app.provider.tablel 


对 于 content://com.example.app.provider/table1/1 这 个 内 容 URI， 它 所 对 应 的 MIME 类 型 就 可 
以 写成 : 
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vnd.android.cursor.item/vnd.com.example.app.provider.tablel 


现在 我 们 可 以 继续 完善 MyProvider 中 的 内 容 了 ， 这 次 来 实现 getType() 方 法 中 的 逻辑 ， 代 
码 如 下 所 示 : 


public class MyProvider extends ContentProvider { 


@Override 
public String getType(Uri uri) { 
switch (uriMatcher.match(uri)) { 
case TABLE1_DIR : 
return "vnd.android.cursor.dir/vnd.com.example.app.provider.tablel"; 
case TABLE1_ITEM : 


return "vnd.android.cursor.item/vnd.com.example.app.provider.tablel"; 
case TABLE2_DIR : 

return "vnd.android.cursor.dir/vnd.com.example.app.provider.table2"; 
case TABLE2_ITEM: 

return "vnd.android.cursor.item/vnd.com.example.app.provider.table2"; 
default: 

break; 


return null; 


} 
到 这 里 ， 一 个 完整 的 内 容 提供 器 就 创建 完成 了 ， 现 在 任何 一 个 应 用 程序 都 可 以 使 用 


ContentResolver 来 访问 我 们 程序 中 的 数据 。 那 么 前 面 所 提 到 的 ， 如 何 才能 保证 隐私 数据 不 会 泄漏 
出 去 呢 ? 其 实 多 亏 了 内 容 提供 器 的 良好 机 制 ， 这 个 问题 在 不 知 不 觉 中 已 经 被 解决 了 。 因 为 所 有 的 
CRUD 操作 都 一 定 要 匹配 到 相应 的 内 容 URI 格式 才能 进行 的 ， 而 我 们 当然 不 可 能 向 UriMatcher 


中 添加 隐私 数据 的 URI， 所 以 这 部 分 数据 根本 无 法 被 外 部 程序 访问 到 ， 安 全 问题 也 就 不 存在 了 。 


好 了 , 创建 内 容 提 供 器 的 步骤 你 也 已 经 清楚 了 ， 下 面 就 来 实战 一 下 ,真正 体验 一 回 跨 程序 数 
据 共 享 的 功能 。 
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简单 起 见 ， 我 们 还 是 在 上 一 章 中 DatabaseTest 项 目的 基础 上 继续 开发 ， 通 过 内 容 提 供需 来 给 
它 加 入 外 部 访问 接口 。 打 开 DatabaseTest 项目， 首先 将 MyDatabaseHelper 中 使 用 Toast 弹出 创建 
数据 库 成 功 的 提示 去 除 掉 ， 因 为 跨 程 序 访问 时 我 们 不 能 直接 使 用 Toast。 然 后 创建 一 个 内 容 提供 
器 ， 右 击 com.example.databasetest 包 一 New 一 Other 一 Content Provider， 会 弹出 如 图 7.13 所 示 的 
窗口 。 
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网 New Android Component 时 呈 


) Configure Component 


Android Studio 


yx 


Creates a new content provider component and adds it to your Android manifest. 


Class Name: DatabaseProvider 


URI Authorities: 


[com.example.databasetest.provider 


Exported 


Enabled 


A semicolon separated list of one or more URI authorities that identify data under the purview of the content provider. 


图 7.13 ”创建 内 容 提供 器 的 窗口 


可 以 看 到 ,这 里 我 们 将 内 容 提 供 器 命名 为 DatabaseProvider,authority 指定 为 com.example. 
databasetest.provider，Exported 属性 表示 是 否 人 允许 外 部 程序 访问 我 们 的 内 容 提供 器 ， 
Enabled 属性 表示 是 否 启用 这 个 内 容 提供 器 。 将 两 个 属性 都 匀 中 ， 点 击 Finish 完成 创建 。 

接着 我 们 修改 DatabaseProvider 中 的 代码 ， 如 下 所 示 : 


public class DatabaseProvider extends ContentProvider { 


public static final int BOOK DIR = 0; 

public static final int BOOK ITEM = 1; 

public static final int CATEGORY DIR = 2; 

public static final int CATEGORY ITEM = 3; 

public static final String AUTHORITY = "com.example.databasetest.provider"; 


private static UriMatcher uriMatcher; 
private MyDatabaseHelper dbHelper; 


static { 
uriMatcher new UriMatcher(UriMatcher.NO MATCH); 
uriMatcher.addURI(AUTHORITY, "book", BOOK DIR); 
uriMatcher.addURI(AUTHORITY, "book/#", BOOK ITEM); 
uriMatcher.addURI(AUTHORITY, "category", CATEGORY DIR); 
uriMatcher.addURI(AUTHORITY, "category/#", CATEGORY ITEM); 
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GOverride 

public boolean onCreate() { 
dbHelper = new MyDatabaseHelper(getContext(), "BookStore.db", null, 2); 
return true; 


} 


GOverride 
public Cursor query(Uri uri, String[] projection, String selection, String[] 
selectionArgs, String sortOrder) { 
// 查询 数据 
SQLiteDatabase db = dbHelper.getReadableDatabase(); 
Cursor cursor = null; 
switch (uriMatcher.match(uri)) { 
case BOOK_DIR: 
cursor = db.query("Book", projection, selection, selectionArgs, null, 
null, sortOrder); 
break; 
case BOOK ITEM: 
String bookId = uri.getPathSegments().get(1); 
cursor = db.query("Book", projection, "id= ?", new String[] { bookId }, 
null, null, sortOrder); 
break; 
case CATEGORY _DIR: 
cursor = db.query("Category", projection, selection, selectionArgs, 
null, null, sortOrder); 
break; 
case CATEGORY ITEM: 
String categoryId = uri.getPathSegments().get(1); 
cursor = db.query("Category", projection, "id = ?", new String[] 
{ categoryId }, null, null, sortOrder); 
break; 
default: 
break; 
} 
return cursor; 


} 


GOverride 
public Uri insert(Uri uri, ContentValues values) { 
// 添加 数据 
SQLiteDatabase db = dbHelper.getwritableDatabase(); 
Uri uriReturn = null; 
switch (uriMatcher.match(uri)) { 
case BOOK_DIR: 
case BOOK ITEM: 
Long newBookId = db.insert("Book", null, values); 
uriReturn = Uri.parse("content://" + AUTHORITY + "/book/" + 
newBookId ) ; 
break ; 
case CATEGORY_DIR : 
case CATEGORY ITEM: 
Long newCategoryId = db.insert("Category", null, values); 
uriReturn = Uri.parse("content://" + AUTHORITY + "/category/" + 
newCategoryId); 
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break; 
default: 
break; 
} 
return uriReturn; 
} 
@Override 


public int update(Uri uri, ContentValues values, String selection, String[] 
selectionArgs) { 
// 更 新 数据 
SQLiteDatabase db = dbHelper.getWritableDatabase(); 
int updatedRows = 0; 
switch (uriMatcher.match(uri)) { 
case BOOK_DIR: 
updatedRows = db.update("Book", values, selection, selectionArgs); 
break; 
case BOOK ITEM: 
String bookId = uri.getPathSegments().get(1 
updatedRows = db.update("Book", values, "id 
{ bookId }); 
break; 
case CATEGORY_DIR: 
updatedRows = db.update("Category", values, selection, 
selectionArgs); 
break ; 
case CATEGORY ITEM: 
String categoryId = Uri.getPath9egments() .get(1 
updatedRows = db.update("Category", values, "id 
{ categoryId }); 


); 
= ?", new String[] 


); 
= ?", new String[] 


break; 
default: 
break; 
} 
return updatedRows ; 
} 
@Override 


public int delete(Uri uri, String selection, String[] selectionArgs) { 
// 删除 数据 
SQLiteDatabase db = dbHelper.getWritableDatabase(); 
int deletedRows = 0; 
Switch (uriMatcher.match(uri)) { 
case BOOK_DIR: 
deletedRows = db.delete("Book", selection, selectionArgs); 
break; 
case BOOK_ITEM: 
String bookId = uri.getPathSegments().get(1); 
deletedRows = db.delete("Book", "id = ?", new String[] { bookId }); 
break; 
case CATEGORY DIR: 
deletedRows = db.delete("Category", selection, selectionArgs); 
break; 
case CATEGORY _ ITEM: 
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String categoryId = uri.getPathSegments().get(1); 
deletedRows = db.delete("Category", "id = ?", new String[] 
{ categoryId }); 
break ; 
default: 
break; 


return deletedRows; 


} 


GOverride 
public String getType(Uri uri) { 
switch (uriMatcher.match(uri)) { 
case BOOK DIR: 
return "vnd.android.cursor.dir/vnd.com.example.databasetest. 
provider.book"; 
case BOOK_ ITEM: 
return "vnd.android.cursor.item/vnd.com.example.databasetest. 
provider.book"; 
case CATEGORY_DIR : 
return "vnd.android.cursor.dir/vnd.com.example.databasetest. 
provider.category"; 
case CATEGORY_ITEM : 
return "vnd.android.cursor.item/vnd.com.example.databasetest. 
provider.category"; 


return null; 


} 


代码 虽然 很 长 ,不 过 不 用 担心 , 这 些 内 容 都 非常 容易 理解 ， 因 为 使 用 到 的 全 部 都 是 上 一 小 节 
中 我 们 学 到 的 知识 。 首 先 在 类 的 一 开始 ， 同 样 是 定义 了 4 个 常量 ， 分 别 用 于 表示 访问 Book 表 中 
的 所 有 数据 、 访 问 Book 表 中 的 单条 数据 、 访 问 Category 表 中 的 所 有 数据 和 访问 Category 表 中 的 
单条 数据 。 然 后 在 静态 代码 块 里 对 UriMatcher 进行 了 初始 化 操作 ， 将 期 望 匹配 的 几 种 URI 格式 
添加 了 进去 。 


接 下 来 就 是 每 个 抽象 方法 的 具体 实现 了 , 先 来 看 下 onCreate ( ) 方 法 , 这 个 方法 的 代码 很 短 ， 
就 是 创建 了 一 个 MyDatabaseHelper 的 实例 ,然后 返回 true 表示 内 容 提供 器 初始 化 成 功 ,这 时 数 
据 库 就 已 经 完成 了 创建 或 升级 操作 。 


接着 看 一 下 query () 方 法 , 在 这 个 方法 中 先 获 取 到 了 SQLiteDatabase 的 实例 , 然后 根据 传人 
的 Uri 参数 判断 出 用 户 想 要 访问 哪 张 表 ， 再 调用 SQLiteDatabase 的 query () 进 行 查询 ， 并 将 
Cursor 对 象 返回 就 好 了 。 注 意 当 访问 单条 数据 的 时 候 有 一 个 细节 ， 这 里 调用 了 Uri 对 象 的 
getPathSegments () 方 法 ， 它 会 将 内 容 URI 权 限 之 后 的 部 分 以 “/” 符 号 进行 分 割 ， 并 把 分 割 后 
的 结果 放 入 到 一 个 字符 串 列表 中 ， 那 这 个 列表 的 第 0 个 位 置 存放 的 就 是 路 径 , 第 1 个 位 置 存 放 的 
就 是 id 了。 得 到 了 id 之后， 再 通过 selection 和 selectionArgs 参数 进行 约束 ， 就 实现 了 查 
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询 单条 数据 的 功能 。 

再 往 后 就 是 insert() 方 法 ， 同 样 它 也 是 先 获取 到 了 SQLiteDatabase 的 实例 ， 然 后 根据 传人 
的 Uri 参数 判断 出 用 户 想 要 往 哪 张 表 里 添加 数据 ， 再 调用 SQLiteDatabase 的 insert() 方 法 进行 
添加 就 可 以 了 。 注 意 insert() 方 法 要 求 返 回 一 个 能 够 表示 这 条 新 增 数据 的 URI， 所 以 我 们 还 需 
要 调用 Uri .parse() 方 法 来 将 一 个 内 容 URI 解 析 成 Uri 对 象 ， 当 然 这 个 内 容 URI 是 以 新 增 数据 
的 id 结尾 的 。 

接 下 来 就 是 update() 方 法 了 ， 相 信 这 个 方法 中 的 代码 已 经 完全 难 不 倒 你 了 。 也 是 先 获 取 
SQLiteDatabase 的 实例 ,然后 根据 传 入 的 Uri 参数 判断 出 用 户 想 要 更 新 哪 张 表 里 的 数据 ， 再 调用 
SQLiteDatabase 的 update() 方 法 进行 更 新 就 好 了 ， 受 影响 的 行 数 将 作为 返回 值 返回 。 

下 面 是 delete() 方 法 ， 是 不 是 感觉 越 到 后 面 越 轻松 了 ? 因为 你 已 经 渐 和 佳境， 真正 地 找到 
窍门 了 。 这 里 仍然 是 先 获取 到 SQLiteDatabase 的 实例 , 然后 根据 传人 的 Uri 参数 判断 出 用 户 想 要 
删除 哪 张 表 里 的 数据 ， 再 调用 SQLiteDatabase 的 deLete( ) 方 法 进行 删除 就 好 了 ， 被 删除 的 行 数 
将 作为 返回 值 返回 。 

最 后 是 getType( ) 方 法 , 这 个 方法 中 的 代码 完全 是 按照 上 一 节 中 介绍 的 格式 规则 编写 的 , 相 
信 已 经 没有 什么 解释 的 必要 了 。 这 样 我 们 就 将 内 容 提 供 器 中 的 代码 全 部 编写 完了 。 

另外 还 有 一 点 需要 注意 ， 内 容 提供 器 一 定 要 在 AndroidManifest.xml 文件 中 注册 才 可 以 使 用 。 
不 过 幸运 的 是 ， 由 于 我 们 是 使 用 Android Studio 的 快捷 方式 创建 的 内 容 提 供 器 ， 因 此 注册 这 一 步 
已 经 被 自动 完成 了 。 打 开 AndroidManifest.xml 文件 瞧 一 瞧 ， 代 码 如 下 所 示 : 


<manifest xmlns:android="http://schemas.android.com/apk/res/android" 
package="com.example.databasetest"> 


Tl 


<application 
android:allowBackup="true" 
android:icon="@mipmap/ic launcher" 
android:label="@string/app_name" 
android:supportsRtl="true" 
android:theme="@style/AppTheme"> 


<provider 
android:name=" .DatabaseProvider" 
android:authorities="com.example.databasetest.provider" 
android:enabled="true" 
android:exported="true"> 
</provider> 
</application> 


</manifest> 


可 以 看 到 ，<application> 标 签 内 出 现 了 一 个 新 的 标签 <provider>， 我 们 使 用 它 来 对 
DatabaseProvider 这 个 内 容 提供 器 进行 注册 ,android:name 属性 指定 了 DatabaseProvider 的 类 名 ， 
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android:authorities 属性 指定 了 DatabaseProvider 的 authority ,而 enabled 和 exported 属性 


TT 


则 是 根据 我 们 刚才 勾 选 的 状态 自动 生成 的 ， 这 里 表示 人 允许 DatabaseProvider 被 其 他 应 用 程序 进行 


访问 。 


现在 DatabaseTest 这 个 项 目 就 已 经 拥有 了 路程 序 共享 数据 的 功能 了 ， 我 们 赶快 来 尝试 一 下 。 
首先 需要 将 DatabaseTest 程序 从 模拟 器 中 删除 掉 ， 以 防止 上 一 章 中 产生 的 遗留 数据 对 我 们 造成 干 


扰 。 然 后 运行 一 下 项 目 ， 将 DatabaseTest 程序 如 


新 安装 在 模拟 器 上 了 。 接 着 关闭 掉 DatabaseTest 


这 个 项 目 ,并 创建 一 个 新 项 目 ProviderTest ,我们 就 将 通过 这 个 程序 去 访问 DatabaseTest 中 的 数据 。 
还 是 先 来 编写 一 下 布局 文件 吧 ， 修 改 activity_main.xml 中 的 代码 ， 如 下 所 示 : 


<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:orientation="vertical" 
android:layout width="match parent" 
android:layout height="match parent" > 


<Button 
android 
android 
android 
android 


<Button 
android 


android: 


android 


android: 


<Button 


android: 


android 


android: 


android 


<Button 
android 


android: 


android 
android 


</LinearLayout> 


:id="@+id/add data" 

:layout width="match parent" 
:layout height="wrap content" 
:text="Add To Book" /> 


:id="@+id/query data" 

layout width="match parent" 
:layout height="wrap content" 
text="Query From Book" /> 


id="@+id/update data" 
:layout width="match parent" 
layout height="wrap content" 
:text="Update Book" /> 


:id="@+id/delete data" 

layout width="match parent" 
:layout height="wrap content" 
:text="Delete From Book" /> 


布局 文件 很 简单 ， 里面 放 置 了 4 个 按钮 , 分别 用 于 添加 、 查 询 、 修 改 和 删除 数据 。 然 后 修改 
MainActivity 中 的 代码 ， 如 下 所 示 : 


public class MainActivity extends AppCompatActivity { 


private String newId ; 


GOverride 


protected void onCreate(Bundle savedInstanceState) { 
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super.onCreate(savedInstanceState), 
setContentView(R.layout.activity main); 
Button addData = (Button) findViewById(R.id.add data); 
addData.setOnClickListener(new View.0nCLickListener() { 
@Override 
public void onClick(View v) { 
// 添加 数据 
Uri uri = Uri.parse("content://com.example.databasetest. provider/ 
book"); 
ContentValues values = new ContentValues(); 
values.put("name", "A Clash of Kings"); 
values.put("author", "George Martin"); 
values.put("pages", 1040); 
values.put("price", 22.85); 
Uri newUri = getContentResolver().insert(uri, values); 
newId = newUri.getPathSegments().get(1); 
} 
}); 
Button queryData = (Button) findViewById(R.id.query data); 
queryData.setOnClickListener(new View.OnClickListener() { 


@Override 
public void onClick(View v) { 
// 查询 数据 
Uri uri = Uri.parse("content://com.example.databasetest. provider/ 
book"); 
Cursor cursor = getContentResolver().query(uri, null, null, null, 
null); 
if (cursor != null) { 
while (cursor.moveToNext()) { 
String name = cursor.getString(cursor. getColumnIndex 
("name")); 
String author = cursor.getString(cursor. getColumnIndex 
("author")); 
int pages = cursor.getInt(cursor.getColumnIndex ("pages")); 
double price = cursor.getDouble(cursor. getCoLumnIndex 
("price")); 
Log.d("MainActivity", "book name is " + name); 
Log.d("MainActivity", "book author is " + author); 
Log.d("MainActivity", "book pages is " + pages); 
Log.d("MainActivity", "book price is " + price); 
} 


cursor.close(); 


} 
}); 
Button updateData = (Button) findViewById(R.id.update data); 
updateData.setOnClickListener(new View.0nCLickListener() { 
@Override 
public void onClick(View v) { 
// 更 新 数据 
Uri uri = Uri.parse("content://com.example.databasetest. provider/ 
book/" + newId); 
ContentValues values = new ContentValues(); 
values.put("name", "A Storm of Swords"); 
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values.put("pages", 1216); 
values.put("price", 24.05); 
getContentResolver().update(uri, values, null, null); 
} 
}); 
Button deleteData = (Button) findViewById(R.id,.delete data); 
deleteData.setOnClickListener(new View.OnClickListener() { 
@Override 
public void onClick(View v) { 
// 删除 数据 
Uri uri = Uri.parse("content://com.example.databasetest. provider/ 
book/" + newId) ; 
getContentResolver().delete(uri, null, null); 
} 
$3 


} 


可 以 看 到 ,我 们 分 别 在 这 4 个 按钮 的 点 击 事件 里 面 处 理 了 增删 改 查 的 钦 辑 ,添加 数据 的 时 候 ， 
首先 调用 了 Uri.parse() 方 法 将 一 个 内 容 URI 解 析 成 Uri 对 象 ， 然 后 把 要 添加 的 数据 都 存放 到 
ContentValues 对 象 中 , 接着 调用 ContentResolver 的 insert() 方 法 执行 添加 操作 就 可 以 了 。 
注意 insert() 方 法 会 返回 一 个 Uri 对 象 , 这 个 对 象 中 包含 了 新 增 数据 的 id, 我 们 通过 getPath- 
Segments() 方 法 将 这 个 id 取出 ， 稍 后 会 用 到 它 。 

查询 数据 的 时 候 ， 同 样 是 调用 了 Uri.parse() 方 法 将 一 个 内 容 URI 解 析 成 Uri 对 象 ， 然 后 
调用 ContentResolver 的 query() 方 法 去 查询 数据 ， 查 询 的 结果 当然 还 是 存放 在 Cursor 对 象 
中 的 。 之 后 对 Cursor 进行 遍历 ， 从 中 取出 查询 结果 ， 并 一 一 打印 出 来 。 


更 新 数据 的 时 候 ， 也 是 先 将 内 容 URI 解析 成 Uri 对 象 ， 然后 把 想 要 更 新 的 数据 存放 到 
ContentValues 对 象 中 ， 再 调用 ContentResolver 的 update() 方 法 执行 更 新 操作 就 可 以 了 。 
注意 这 里 我 们 为 了 不 想 让 Book 表 中 的 其 他 行 受 到 影响 ， 在 调用 Uri.parse() 方 法 时 ,给 内 容 
URI 的 尾部 增加 了 一 个 这， 而 这 个 id 正 是 添加 数据 时 所 返回 的 。 这 就 表示 我 们 只 希望 更 新 刚刚 
添加 的 那 条 数据 ，Book 表 中 的 其 他 行 都 不 会 受 影响 。 

删除 数据 的 时 候 ， 也 是 使 用 同样 的 方法 解析 了 一 个 以 id 结尾 的 内 容 URI， 然 后 调用 
ContentResolver 的 detLete() 方 法 执行 删除 操作 就 可 以 了 。 由 于 我 们 在 内 容 URI 里 指定 了 一 个 
id， 因 此 只 会 删 掉 拥有 相应 id 的 那 行 数据 ，Book 表 中 的 其 他 数据 都 不 会 受 影响 。 


现在 运行 一 下 ProviderTest 项目, 会 显示 如 图 7.14 所 示 的 界面 。 
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i 9:40 


ProviderTest 


ADD TO BOOK 


QUERY FROM BOOK 


UPDATE BOOK 


DELETE FROM BOOK 


4 oO 口 


图 7.14 ProviderTest 主 界面 


点 击 一 下 Add To Book 按钮 ， 此 时 数据 就 应 该 已 经 添加 到 DatabaseTest 程序 的 数据 库 中 了 ， 
我 们 可 以 通过 点 击 Query From Book 按钮 来 检查 一 下 ， 打 印 日 志 如 图 7.15 所 示 。 


lverbose 加 G- ) 


com. example. providertest D/MainActivity: book name is A Clash of Kings 


com. example. providertest D/MainActivity: book author is George Martin 
com. example. providertest D/MainActivity: book pages is 1040 


com. example. providertest D/MainActivity: book price is 22.85 


图 7.15 查询 添加 的 数据 


然后 点 击 一 下 Update Book 按钮 来 更 新 数据 ， 再 点 击 一 下 Query From Book 按钮 进行 检查 ， 
结果 如 图 7.16 所 示 。 


二 ~ 
[Verbose "| @Q- ) 
J 


com. example. providertest D/MainActivity: book name is A Storm of Swords 


com. example. providertest D/MainActivity: book author is George Martin 
com. example. providertest D/MainActivity: book pages is 1216 


com. example. providertest D/MainActivity: book price is 24.05 


图 7.16 查询 更 新 后 的 数据 


最 后 点 击 Delete From Book 按钮 删除 数据 ， 此 时 再 点 击 Query From Book 按钮 就 查询 不 到 数 
据 了 。 由 此 可 以 看 出 ， 我 们 的 跨 程 序 共 享 数据 功 能 已 经 成 功 实 现 了 ! 现在 不 仅 是 ProviderTest 程 
序 ， 任 何 一 个 程序 都 可 以 轻松 访问 DatabaseTest 中 的 数据 ， 而 且 我 们 还 丝毫 不 用 担心 隐私 数据 潭 
漏 的 问题 。 


到 这 里 , 与 内 容 提 供需 相关 的 重要 内 容 就 基本 全 部 介绍 完了 ,下 面 就 让 我 们 再 次 进入 本 书 的 
特殊 环节 ， 学 习 更 多 关于 Git 的 用 法 。 


7.5 ”Git 时 间 
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7.5 _Git 时 间 一 一 版 本 控制 工具 进 阶 
在 上 一 次 的 Git 时 间 里 ， 我 们 学 习 了 关于 Git 最 基本 的 用 法 ， 包 括 安装 Git、 


创建 代码 仓库 ， 


以 及 提交 本 地 代码 。 本 方 中 我 们 将 要 学 习 更 多 的 使 用 技巧 ,不 过 在 开始 之 前 先 要 把 准备 工作 做 好 。 


所 谓 的 准备 工作 就 是 要 给 一 个 项 目 创建 代码 仓库 , 这 里 就 选择 在 ProviderTest 项目 中 创建 吧 ， 
打开 Git Bash， 进 入 到 这 个 项 目的 根 目录 下 面 ， 然 后 执行 git init 命令 ， 如 图 7.17 所 示 。 


图 7.17 创建 代码 仓库 
这 样 准备 工作 就 已 经 完成 了 ， 让 我 们 继续 开始 Git 之 旅 吧 。 


7.5.1 忽略 文件 
代码 仓库 现在 已 经 创建 好 了 ， 接 下 来 我 们 应 该 去 提交 ProviderTest 项 目 中 的 代码 。 不 过 在 提 


交 之 前 你 也 许 应 该 思考 一 下 ， 是 不 是 所 有 的 文件 都 需要 加 入 到 版 本 控制 当中 呢 ? 


在 第 1 章 介绍 Android 项 目 结构 的 时 候 有 提 到 过 , build 目录 下 的 文件 都 是 纪 


译 项 目 时 自动 生 


成 的 ， 我们 不 应 该 将 这 部 分 文件 添加 到 版 本 控制 当中 ， 那 么 如 何 才能 实现 这 样 的 效果 呢 ? 


Git 提供 了 一 种 可 配 性 很 强 的 机 制 来 允许 用 户 将 指定 的 文件 或 目录 排除 在 版 本 控制 之 外 ， 它 


会 检查 代码 仓库 的 目录 下 是 否 存 在 一 个 名 为 .gitignore 的 文件 , 如 果 存 在 的 话 , 就 去 一 行 行 读 取 这 
个 文件 中 的 内 容 , 并 把 每 一 行 指定 的 文件 或 目录 排除 在 版 本 控制 之 外 。 注意 .gitignore 中 指定 的 文 


件 或 目录 是 可 以 使 用 “*” 通 配 符 的 。 


J 


动 帮 我 们 创建 出 两 个 .gitignore 文件 , 一 个 在 根 日 录 下 面 , 一 个 在 app 模块 下 面 。 
录 下 面 的 .gitignore 文件 ， 如 图 7.18 所 示 。 


| 目 ‘gitignore x 
来. Im] v 
Eradle 
/local. properties 
/idea/workspace. xml 
/.idea/libraries 
DS_Store 
/build 
feaptures 


图 7.18 根 目 录 下 面 的 .gitignore 文件 


中 奇 的 是 ， 我 们 并 不 需要 自己 去 创建 .gitignore 文件 ，Android Studio 在 创建 项 目的 时 候 会 自 


首先 看 一 下 根 目 


这 是 Android Studio 自动 生成 的 一 些 默认 配置 ， 通 常情 况 下 ， 这 部 分 内 容 都 是 不 用 添加 到 版 
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本 控制 当中 的 。 我 们 来 简单 阅读 一 下 这 个 文件 , 除了 *.iml 表示 指定 任意 以 .iml 结尾 的 文件 , 其 他 
都 是 指定 的 具体 的 文件 名 或 者 目录 名 ， 上 面 配置 中 的 所 有 内 容 都 不 会 被 添加 到 版 本 控制 当中 ， 
为 基本 都 是 一 些 由 IDE 自动 生成 的 配置 。 


再 来 看 一 下 app 模块 下 面 的 .gitignore 文件 ， 这 个 就 简单 多 了 ， 如 图 7.19 所 示 。 


目 app\.gitignore x 


/build 本 


图 7.19 app 模块 下 面 的 .gitignore 文件 
由 于 app 模块 下 面 基本 都 是 我 们 编写 的 代码 ， 因 此 默认 情况 下 只 有 其 中 的 build 目录 不 会 被 
添加 到 版 本 控制 当中 。 
当然 ， 我 们 完全 可 以 对 以 上 两 个 文件 进行 任意 地 修改 ， 来 满足 特定 的 需求 。 比 如 说 ，app 模 
块 下 面 的 所 有 测试 文件 都 只 是 给 我 自己 使 用 的 , 我 并 不 想 把 它们 添加 到 版 本 控制 中 , 那么 就 可 以 
这 样 修改 app/.gitignore 文件 中 的 内 容 : 


/build 
/src/test 
/src/androidTest 


没 错 ， 只 需 添加 这 样 两 行 配置 ， 因 为 所 有 的 测试 文件 都 是 放 在 这 两 个 目录 下 的 。 现 在 我 们 可 
以 提交 代码 了 ， 先 使 用 add 命令 将 所 有 的 文件 进行 添加 ， 如 下 所 示 : 

git add . 

然后 执行 commit 命令 完成 提交 ， 如 下 所 示 : 


git commit -m "First commit." 


7.5.2 ”查看 修改 内 容 


在 进行 了 第 一 次 代码 提交 之 后 , 我 们 后 面 还 可 能 会 对 项 目 不 断 地 进行 维护 或 添加 新 功能 等 。 
比较 理想 的 情况 是 每 当 完成 了 一 小 块 功能 ， 就 执行 一 次 提交 。 但 是 如 果 某 个 功能 牵扯 到 的 代码 
比较 多 ， 有 可 能 写 到 后 面 的 时 候 我 们 就 已 经 忘记 前 面 修改 了 什么 东西 了 。 遇 到 这 种 情况 时 不 用 
担心 ，Git 全 都 帮 你 记 着 呢 ! 下 面 我 们 就 来 学 习 一 下 如 何 使 用 Git 来 查看 自 上 次 提交 后 文件 修改 
的 内 容 。 


查看 文件 修改 情况 的 方法 非常 简单 ， 只 需要 使 用 status 命令 就 可 以 了 ,在 项 目的 根 目 录 下 
输入 如 下 命令 : 


git status 
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然后 Git 会 提示 目前 项 目 中 没有 任何 可 提交 的 文件 ， 因 为 我 们 刚刚 才 提 交 过 嘛 。 现 在 对 
ProviderTest 项 目 中 的 代码 稍 做 一 下 改动 ， 修 改 MainActivity 中 的 代码 ， 如 下 所 示 : 


public class MainActivity extends AppCompatActivity { 
GOverride 
protected void onCreate(Bundle savedInstanceState) { 
addData.setOnClickListener(new OnClickListener() { 


@Override 
public void onClick(View v) { 


values.put("price", 55.55); 


这 里 仅仅 是 在 添加 数据 的 时 候 ,将 书 的 价格 由 22.85 改 成 了 55.55。 然 后 重新 输入 git status 
命令 ， 这 次 结果 如 图 7.20 所 示 。 


图 7.20 查看 文件 变动 情况 


可 以 看 到 , Git 提醒 我 们 MainActivity.java 这 个 文件 已 经 发 生 了 更 改 , 那么 如 何 才 能 看 到 更 改 
的 内 容 呢 ? 这 就 需要 借助 diff 命令 了 ， 用 法 如 下 所 示 : 


git diff 

这 样 可 以 查看 到 所 有 文件 的 更 改 内 容 ， 如 果 你 只 想 查 看 MainActivityjava 这 个 文件 的 更 改 内 
可 以 使 用 如 下 命令 : 

git diff app/src/main/java/com/example/providertest/MainActivity.java 


命令 的 执行 结果 如 图 7.21 所 示 。 


SN 
MA 


图 7.21 查看 修改 的 具体 内 容 
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其 中 , 减 号 代表 删除 的 部 分 ， 加 号 代表 添加 的 部 分 。 从 图 中 我 们 就 可 以 明显 地 看 出 , 书 的 价 
格 由 22.85 被 修改 成 了 55.55。 


7.5.3 ”撤销 未 提交 的 修改 

有 时 候 我 们 的 代码 可 能 会 写 得 过 于 草率 ,以 至 于 原本 正常 的 功能 , 结果 反倒 被 我 们 改 出 了 问 
题 。 遇 到 这 种 情况 时 也 不 用 着 急 ， 因 为 只 要 代码 还 未 提交 ， 所 有 修改 的 内 容 都 是 可 以 撤销 的 。 
比如 在 上 一 小 节 中 我 们 修改 了 MainActivity 里 一 本 书 的 价格 , 现在 如 果 想 要 撤销 这 个 修改 就 
可 以 使 用 checkout 命令 ， 用 法 如 下 所 示 : 

git checkout app/src/main/java/com/example/providertest/MainActivity.java 

执行 了 这 个 命令 之 后 ,我 们 对 MainActivityjava 这 个 文件 所 做 的 一 切 修改 就 应 该 都 被 撤销 了 。 
重新 运行 git status 命令 检查 一 下 ， 结 果 如 图 7.22 所 示 。 


到 7.22 重新 查看 文件 变动 情况 
可 以 看 到 ， 当 前 项 目 中 没有 任何 可 提交 的 文件 ， 说 明 撤 销 操作 确实 是 成 功 了 。 
不 过 这 种 撤销 方式 只 适用 于 那些 还 没有 执行 过 add 命令 的 文件 ,如 果 某 个 文件 已 经 被 添加 过 
了 ， 这 种 方式 就 无 法 撤销 其 更 改 的 内 容 ， 我 们 来 做 个 试验 瞧 一 瞧 。 
首先 仍然 是 将 MainActivity 中 那 本 书 的 价格 改 成 55.55， 然 后 输入 如 下 命令 : 


git add . 


这 样 就 把 所 有 修改 的 文件 都 进行 了 添加 ， 可 以 输入 git status 来 检查 一 下 ， 结 果 如 图 7.23 
所 示 。 


现在 我 们 再 执行 一 遍 checkout 命令 ， 你 会 发 现 MainActivity 仍然 是 处 于 已 添加 状态 ， 所 修 
改 的 内 容 无 法 撤销 掉 。 

这 种 情况 应 该 怎么 办 ? 难道 我 们 还 没 法 后 悔 了 ? 当然 不 是 , 只 不 过 对 于 已 添加 的 文件 我 们 应 
该 先 对 其 取消 添加 ， 然 后 才 可 以 撤回 提交 。 取 消 添加 使 用 的 是 reset 命令 ， 用 法 如 下 所 示 : 


本 
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git reset HEAD app/src/main/java/com/example/providertest/MainActivity.java 


然后 再 运行 一 遍 git status 命令 ， 你 就 会 发 现 MainActivityjava 这 个 文件 重新 变 回 了 未 添 
加 状态 ， 此 时 就 可 以 使 用 checkout 命令 来 将 修改 的 内 容 进行 撤销 了 。 


7.5.4 查看 提交 记录 


当 ProviderTest 这 个 项 目 开 发 了 几 个 月 之 后 ， 我 们 可 能 已 经 执行 过 上 百 次 的 提交 操作 了 ， 这 
个 时 候 估计 你 早 就 已 经 忘记 每 次 提交 都 修改 了 哪些 内 容 。 不 过 没关系 ， 忠 实 的 Git 一直 都 帮 有 我 们 


老林 林 


清 清 楚楚 地 记录 着 呢 ! 可 以 使 用 1og 命令 查看 历史 提交 信息 ， 用 法 如 下 所 示 : 


DE) 


git log 


由 于 目前 我 们 只 执行 过 一 次 提交 ， 所 以 能 看 到 的 信息 很 少 ， 如 图 7.24 所 示 。 


图 7.24 查看 提交 记录 
可 以 看 到 ,每 次 提交 记录 都 会 包含 提交 id、 提 交 人 、 提 交 日 期 以 及 提交 描述 这 4 个 信息 。 那 
么 我 们 再 次 将 书 价 修 改 成 55.55， 然 后 执行 一 次 提交 操作 ， 如 下 所 示 : 


git add ， 
git commit -m "Change price." 


现在 重新 执行 git log 命令 ,结果 如 图 7.25 所 示 。 


图 7.25 重新 查看 提交 记录 


当 提交 记录 非常 多 的 时 候 , 如 果 我 们 只 想 查 看 其 中 一 条 记录 , 可 以 在 命令 中 指定 该 记录 的 id， 
并 加 上 -1 参数 表示 我 们 只 想 看 到 一 行 记录 ， 如 下 所 示 : 


git log lfa380b502a00b82bfc8d84c5ab5e1l5b8fbf7ydac -1 


而 如 果 想 要 查看 这 条 提交 记录 具体 修改 了 什么 内 容 , 可 以 在 命令 中 加 入 -p 参数 , 命令 如 下 : 
git Log lfa380b502a00b82bfc8d84c5ab5e1l5b8fbf7dac -1 -p 


ba 
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查询 出 的 结果 如 图 7.26 所 示 ， 其 中 减 号 代表 删除 的 部 分 ， 加 号 代表 添加 的 部 分 。 


图 7.26 查看 提交 记录 的 具体 修改 内 容 
好 了 ,本 次 的 Git 时 间 就 到 这 里 ， 下 面 我 们 来 对 本 章 中 所 学 的 知识 做 个 回顾 吧 。 


7.6 小结 与 点 评 


本 章 的 内 容 不 算 多 , 而 且 很 多 时 候 都 是 在 使 用 上 一 章 中 学 习 的 数据 库 知识 ， 所 以 理解 这 部 分 
内 容 对 你 来 说 应 该 是 比较 轻松 的 吧 。 在 本 章 中 ,我 们 一 开始 先 了 解 了 Android 的 权限 机 制 ， 并且 
学 会 了 如 何在 6.0 以 上 的 系统 中 使 用 运行 时 权限 ， 然 后 又 重点 学 习 了 内 容 提供 器 的 相关 内 容 ， 以 
实现 跨 程序 数据 共享 的 功能 。 现在 你 不 仅 知 道 了 如 何 去 访 问 其 他 程序 中 的 数据 , 还 学 会 了 怎样 创 
建 自己 的 内 容 提 供 器 来 共享 数据 ， 收 获 还 是 挺 大 的 吧 。 

不 过 每 次 在 创建 内 容 提供 器 的 时 候 , 你 都 需要 提醒 一 下 自己 , 我 是 不 是 应 该 这 么 做 ? 因为 只 
有 真正 需要 将 数据 共享 出 去 的 时 候 我 们 才 应 该 创建 内 容 提供 器 , 仅仅 是 用 于 程序 内 部 访问 的 数 ] 
就 没有 必要 这 么 做 ， 所 以 千 万 别 对 它 进 行 滥用 。 

在 连续 学 了 几 章 系统 机 制 方 面 的 内 容 之 后 是 不 是 感 党 有 些 枯燥 ? 那么 下 一 章 中 我 们 就 来 换 
换 口味 ， 学 习 一 下 Android 多 媒体 方面 的 知识 吧 。 


开 
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吊 口 早 


丰富 你 的 程序 一 一 运用 手机 多 媒体 


在 过 去 , 手机 的 功能 都 比较 单调 , 仅仅 就 是 用 来 打 电话 和 发 短信 的 。 而 如 今 ， 手机 在 我 们 的 
生活 中 正 扮演 着 越 来 越 重要 的 角色 ,各 种 娱乐 方式 都 可 以 在 手机 上 进行 。 上 班 的 路 上 太 无 聊 ， 可 
以 戴 着 耳机 听 音 乐 。 外 出 旅行 的 时 候 ， 可 以 在 手机 上 看 电影 。 无 论 走 到 哪里 ， 遇 到 喜欢 的 事物 都 
可 以 随手 拍 下 来 。 

众多 的 娱乐 方式 少不了 强大 的 多 媒体 功能 的 支持 ， 而 Android 在 这 方面 也 做 得 非常 出 色 。 它 
提供 了 一 系列 的 API， 使 得 我 们 可 以 在 程序 中 调用 很 多 手机 的 多 媒体 资源 ， 从 而 编写 出 更 加 丰富 
多 彩 的 应 用 程序 ， 本 章 我 们 就 将 对 Android 中 一 些 常用 的 多 媒体 功能 的 使 用 技巧 进行 学 习 。 

前 面 的 7 章 内 容 , 我 们 一 直 都 是 使 用 模拟 器 来 运行 程序 的 , 不 过 本 章 涉及 的 一 些 功 能 必须 要 
在 真正 的 Android 手机 上 运行 才 看 得 到 效果 。 因 此 ， 首 先 我 们 就 来 学 习 一 下 ， 如 何 使 用 Android 
手机 来 运行 程序 。 


8.1 将 程序 运行 到 手机 上 
不 必 我 多 说 ， 首 先 你 需要 拥有 一 部 Android 手机 。 现 在 Android 手机 早 就 不 是 什么 稀罕 物 ， 


几乎 已 经 是 人 手 一 部 了 ， 如 果 你 还 没有 的 话 ， 赶 紧 去 购买 吧 。 


想 要 将 程序 运行 到 手机 上 , 我 们 需要 先 通过 数据 线 把 手机 连接 到 电脑 上 。 然后 进入 到 设置 一 
开发 者 选项 界面 ， 并 在 这 个 界面 中 多 选中 USB 调试 选项 ， 如 图 8.1 所 示 。 
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《4 开发 者 选项 


开启 


调试 

USB 调 ji 

连接 USB 后 启用 调试 模式 @ 
撤消 USB 调 试 授权 


错误 报告 快捷 方式 
在 流 冰 间 中 轩 示 用 于 提交 错误 最 告 的 按 » 


选择 模拟 位 置信 息 应 用 
尚未 设置 模拟 位 置信 息 应 用 


启用 视图 属性 检查 功能 » 


选择 调试 应 用 
未 设置 任何 调试 应 用 


4 (@) 口 
图 8.1 启用 USB 调试 
注意 从 Android 4.2 系统 开始 ， 开 发 者 选项 默认 是 隐藏 的 ， 你 需要 先进 入 到 “关于 手机 ” 界 
面 ， 然 后 对 着 最 下 面 的 版 本 号 那 一 栏 连续 点 击 ， 就 会 让 开发 者 选项 显示 出 来 。 


然后 如 果 你 使 用 的 是 Windows 操作 系统 ， 还 需要 在 电脑 上 安装 手机 的 驱动 。 一 般 借助 360 
手机 助手 或 统 豆 荚 等 工具 都 可 以 快速 地 进行 安装 , 安装 完成 后 就 可 以 看 到 手机 已 经 连接 到 电脑 上 
了 ， 如 图 8.2 所 示 。 


GB | 加 加 


视频 。 壁纸 主题 电子 书 应 用 图 


查 杀 木马 手机 病 


手机 定期 体检 ,保持 最 佳 状态 


速度， 清理 手机 垃圾 


CB | 蕊 夫 - 


立 下 面 有 你 喜欢 的 游戏 陛 


图 8.2 手机 成 功 连接 上 电脑 


现在 观察 Android Monitor, 你 会 发 现 当 前 是 有 两 个 设备 在 线 的 , 一 个 是 我 们 一 直 使 用 的 模拟 
如 ， 男 外 一 个 则 是 刚刚 连接 上 的 手机 了 ， 如 图 8.3 所 示 。 
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LGE Nexus 5 A 


图 8.3 在 线 设 备 列表 


然后 运行 一 下 当前 项 目 ,这 时 不 会 直接 将 程序 运行 到 模拟 器 或 者 手机 上 ， 而 是 会 弹出 一 个 对 
话 框 让 你 进行 选择 ， 如 图 8.4 所 示 。 


y 
网 Select Deployment Target 2 


‘Connected Devices 
国 Nexus 5X API 24 (Android 7.0, API 24) 
LGE Nexus 5 (Android 6.0.1, API 23) 


Create New Virtual Device | Don't see your device? 
DD Use same selection for future launches EE Cancel | 
| 


图 8.4 选择 运行 设备 对 话 杠 


选中 下 面 的 LGE Nexus 5 后 点 击 OK， 就 会 将 程序 运行 到 手机 上 了 。 


8.2 ”使 用 通知 


通知 ( Notification ) 是 Android 系统 中 比较 有 特色 的 一 个 功能 ， 当 某 个 应 用 程序 希望 向 用 户 
发 出 一 些 提示 信息 , 而 该 应 用 程序 又 不 在 前 台 运行 时 , 就 可 以 借助 通知 来 实现 。 发 出 一 条 通知 后 ， 
手机 最 上 方 的 状态 栏 中 会 显示 一 个 通知 的 图 标 , 下拉 状态 栏 后 可 以 看 到 通知 的 详细 内 容 。 Android 
的 通知 功能 获得 了 大 量 用 户 的 认可 和 喜爱 ， 就 连 iOS 系统 也 在 5.0 版 本 之 后 加 入 了 类 似 的 功能 。 


8.2.1 ”通知 的 基本 用 法 


了 解 了 通知 的 基本 概念 , 下 面 我 们 就 来 看 一 下 通知 的 使 用 方法 吧 。 通知 的 用 法 还 是 比较 灵活 
的 ， 既 可 以 在 活动 里 创建 ,也 可 以 在 广播 接收 需 里 创建 ， 当 然 还 可 以 在 下 一 章 中 我 们 即将 学 习 的 
服务 里 创建 。 相 比 于 广播 接收 器 和 服务 ,在 活动 里 创建 通知 的 场景 还 是 比较 少 的 ， 因 为 一 般 只 有 
当 程 序 进入 到 后 台 的 时 候 我 们 才 需 要 使 用 通知 。 

不 过 , 无 论 是 在 哪里 创建 通知 ,整体 的 步骤 都 是 相同 的 ,下面 我 们 就 来 学 习 一 下 创建 通知 的 
详细 步 又。 首先 需要 一 个 NotificationManager 来 对 通知 进行 管理 ,可 以 调用 Context 的 getSystem- 
Service() 方 法 获取 到 。getSystemService() 方 法 接收 一 个 字符 串 参 数 用 于 确定 获取 系统 的 哪 
个 服务 , 这 里 我 们 传人 Context .NOTIFICATION_ SERVICE 即 可 。 因此 , 获取 NotificationManager 
的 实例 就 可 以 写成 : 
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NotificationManager manager = (NotificationManager) 

getSystemService(Context.NOTIFICATION SERVICE) ， 

接 下 来 需要 使 用 一 个 Builder 构造 器 来 创建 Notification 对 象 , 但 问题 在 于 , 几乎 Android 
系统 的 每 一 个 版 本 都 会 对 通知 这 部 分 功能 进行 或 多 或 少 的 修改 ,API 不 稳定 性 问题 在 通知 上 面 突 
显得 尤其 严重 。 那 么 该 如 何 解 决 这 个 问题 呢 ? 其 实 解决 方案 我 们 之 前 已 经 见 过 好 几 回 了 ,就 是 使 
用 support 库 中 提供 的 兼容 API。support-v4 库 中 提供 了 一 个 NotificationCompat 类 , 使 用 这 个 
类 的 构造 器 来 创建 Notification 对 象 , 就 可 以 保证 我 们 的 程序 在 所 有 Android 系统 版 本 上 都 能 
正常 工作 了 ， 代 码 如 下 所 示 : 


Notification notification = new NotificationCompat.Builder(context).build(); 


当然 ， 上 述 代码 只 是 创建 了 一 个 空 的 Notification 对 象 , 并 没有 什么 实际 作用 , 我 们 可 以 
在 最 终 的 build() 方 法 之 前 连 级 任意 多 的 设置 方法 来 创建 一 个 丰富 的 Notification 对 象 , 先 来 
看 一 些 最 基本 的 设置 : 
Notification notification = new NotificationCompat.Builder(context) 
.SetContentTitle("This is content title") 
.SetContentText("This is content text") 
.Setwhen(System.currentTimeMillis()) 
.SetSmallIcon(R.drawable.small icon) 
.SetLargeIcon(BitmapFactory.decodeResource(getResources ()， 
R.drawable.large icon) ) 
.build(); 
上 述 代码 中 一 共 调 用 了 5 个 设置 方法 ,下面 我 们 来 一 一 解析 一 下 。setContentTitle() 方 法 
用 于 指定 通知 的 标题 内 容 ， 下 拉 系 统 状 态 栏 就 可 以 看 到 这 部 分 内 容 。setContentText() 方 法 用 
于 指定 通知 的 正文 内 容 ， 同样 下 拉 系 统 状 态 栏 就 可 以 看 到 这 部 分 内 容 。setWhen () 方 法 用 于 指定 
通知 被 创建 的 时 间 ， 以 毫秒 为 单位 ， 当 下 拉 系 统 状 态 栏 时 ,这 里 指定 的 时 间 会 显示 在 相应 的 通知 
上 。setSmallIcon() 方 法 用 于 设置 通知 的 小 图 标 ， 注 意 只 能 使 用 纯 alpha 图 层 的 图 片 进行 设置 ， 
小 图 标 会 显示 在 系统 状态 栏 上 。setLargeIcon() 方 法 用 于 设置 通知 的 大 图 标 ， 当 下 拉 系 统 状态 
栏 时 ， 就 可 以 看 到 设置 的 大 图 标 了 。 
以 上 工作 都 完成 之 后 ， 只 需要 调用 NotificationManager 的 notify() 方 法 就 可 以 让 通知 显示 
出 来 了 。notify () 方 法 接收 两 个 参数 ， 第 一 个 参数 是 id ， 要 保证 为 每 个 通知 所 指定 的 id 都 是 
不 同 的 。 第 二 个 参数 则 是 Notification 对 象 , 这 里 直接 将 我 们 刚刚 创建 好 的 Notification 对 
象 传人 即 可 。 因 此 ， 显 示 一 个 通知 就 可 以 写成 : 


manager.notify(1, notification); 

到 这 里 就 已 经 把 创建 通知 的 每 一 个 步 又 都 分 析 完 了 , 下面 就 让 我 们 通过 一 个 具体 的 例子 来 看 
一 看 通知 到 底 是 长 什么 样 的 。 
新 建 一 个 NotificationTest 项目， 并 修改 activity_main.xml 中 的 代码 ， 如 下 所 示 : 
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<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:orientation="vertical" 
android:layout width="match parent" 
android:layout height="match parent"> 


<Button 
android:id="@+id/send notice" 
android:layout width="wrap_ content" 
android:layout height="wrap content" 
android:text="Send notice" /> 


</LinearLayout> 


布局 文件 非常 简单 ， 里 面 只 有 一 个 Send notice 按钮 ， 用 于 发 出 一 条 通知 。 接 下 来 修改 
MainActivity 中 的 代码 ， 如 下 所 示 : 


public class MainActivity extends AppCompatActivity implements View.OnClickListener { 


GOverride 

protected void onCreate(Bundle savedInstanceState) { 
super.onCreate(savedInstanceState); 
setContentView(R.layout.activity main); 
Button sendNotice = (Button) findViewById(R.id.send notice); 
sendNotice.setOnClickListener(this); 

} 


GOverride 
public void onClick(View v) { 
switch (v.getId()) { 
case R.id.send notice: 
NotificationManager manager = (NotificationManager) getSystemService 
(NOTIFICATION SERVICE); 

Notification notification = new NotificationCompat.Builder(this) 
.SetContentTitle("This is content title") 
.SetContentText("This is content text") 
.Setwhen(System.currentTimeMillis()) 
.SetSmallIcon(R.mipmap.ic launcher) 
.SetLargeIcon(BitmapFactory.decodeResource(getResources ()， 

R.mipmap.ic Launcher) ) 


.build(); 
manager.notify(1, notification); 
break; 

default: 
break; 


} 


可 以 看 到 , 我 们 在 Send notice 按钮 的 点 击 事件 里 面 完 成 了 通知 的 创建 工作 , 创建 的 过 程 正如 
前 面 所 描述 的 一 样 ,不 过 这 里 简单 起 见 ,我 将 通知 栏 的 大 小 图 都 直接 设置 成 了 ic_launcher 这 张 图 ， 
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这 样 就 不 用 再 去 专门 准备 图 标 了 ， 而 在 实际 项 目 中 千 万 不 要 这 样 偷懒 。 


现在 可 以 来 运行 一 下 程序 了 , 点 击 Send notice 按钮 , 你 会 在 系统 状态 栏 的 最 左边 看 到 一 个 小 
图 标 ， 如 图 8.5 所 示 。 


NotificationTest 


SEND NOTICE 


图 8.5 通知 的 小 图 标 
下 拉 系 统 状态 栏 可 以 看 到 该 通知 的 详细 信息 ， 如 图 8.6 所 示 。 


图 8.6 通知 的 详细 信息 
如 果 你 使 用 过 Android 手机 ， 此 时 应 该 会 下 意识 地 认为 这 条 通知 是 可 以 点 击 的 。 但 是 当 你 去 


点 击 它 的 时 候 ， 你 会 发 现 没有 任何 效果 。 不 对 啊 ,， 好像 每 条 通知 点 击 之 后 都 应 该 会 有 反应 的 呀 ? 
其 实 要 想 实现 通知 的 点 击 效果 ,我 们 还 需要 在 代码 中 进行 相应 的 设置 , 这 就 涉及 了 一 个 新 的 概念 : 
PendingJntent。 

PendingIntent 从 名 字 上 看 起 来 就 和 Intent 有 些 类 似 ， 它 们 之 间 也 确实 存在 着 不 少 共同 点 。 比 
如 它们 都 可 以 去 指明 某 一 个 “意图 ”， 都 可 以 用 于 启动 活动 、 启 动 服务 以 及 发 送 广播 等 。 不 同 的 
是 ，Intent 更 加 倾向 于 去 立即 执行 某 个 动作 ， 而 PendingIntent 更 加 倾向 于 在 某 个 合适 的 时 机 去 执 
行 某 个 动作 。 所 以 ， 也 可 以 把 PendingIntent 简单 地 理解 为 延迟 执行 的 Intent。 


PendingIntent 的 用 法 同样 很 简单 , 它 主要 提供 了 几 个 静态 方法 用 于 获取 PendingIntent 的 实例 ， 
可 以 根据 需求 来 选择 是 使 用 getActivity() 方 法 、getBroadcast () 方 法 ， 还 是 getService() 
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方法 。 这 几 个 方法 所 接收 的 参数 都 是 相同 的 ， 第 一 个 参数 依旧 是 Context, 不 用 多 做 解释 。 第 二 
个 参数 一 般 用 不 到 ， 通 常 都 是 传人 0 即 可 。 第 三 个 参数 是 一 个 Intent 对 象 ， 我 们 可 以 通过 这 个 
对 象 构 建 出 PendingIntent 的 “意图 ”。 第 四 个 参数 用 于 确定 PendingIntent 的 行为 ， 有 FLAG_ONE_ 
SHOT、 FLAG NO CREATE. FLAG CANCEL CURRENT 和 FLAG UPDATE CURRENT 这 4 种 值 可 选 ， 每 
种 值 的 具体 含义 你 可 以 查看 文档 ， 通 常情 况 下 这 个 参数 传人 0 就 可 以 了 。 


B 
P 


对 PendingIntent 有 了 一 定 的 了 解 后 ， 我 们 再 回 过 头 来 看 一 下 NotificationCompat . 
uilder。 这 个 构造 器 还 可 以 再 连 级 一 个 setContentIntent() 方 法 ， 接 收 的 参数 正 是 一 个 
endingIntent 对 象 。 因 此 ， 这 里 就 可 以 通过 PendingIntent 构建 出 一 个 延迟 执行 的 “意图 ”， 当 


用 户 点 击 这 条 通知 时 就 会 执行 相应 的 逻辑 。 


现在 我 们 来 优化 一 下 NotificationTest 项 目 , 给 刚才 的 通知 加 上 点 击 功能 ,让 用 户 点 击 它 的 时 


候 可 以 启动 另 一 个 活动 。 


首先 需要 准备 好 男 一 个 活动 ， 右 击 com.example.notificationtest 包 一 New 一 Activity 一 Empty 


Activity ,新 建 NotificationActivity ,布局 起 名 为 notification layout。 然 后 修改 notification layout.xml 
中 的 代码 ， 如 下 所 示 : 


<RelativeLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:layout width="match parent" 
android:layout height="match parent" > 


<TextView 
android:layout width="wrap_content " 
android:layout height="wrap content" 
android:layout centerInParent="true" 
android:textSize="24sp" 
android:text="This is notification layout" 
/> 


</RelativeLayout> 


这 样 就 把 NotificationActivity 这 个 活动 准备 好 了 ， 下 面 我 们 修改 MainActivity 中 的 代码 ， 给 


通知 加 入 点 击 功 能 ， 如 下 所 示 : 


public class MainActivity extends AppCompatActivity impLements View.OnClickListener { 


@Override 
public void onClick(View v) { 
switch (v.getId()) { 
case R.id.send notice: 
Intent intent = new Intent(this, NotificationActivity.class); 
PendingIntent pi = PendingIntent.getActivity(this, 0, intent, 0); 
NotificationManager manager = (NotificationManager) getSystemService 
(NOTIFICATION SERVICE); 
Notification notification = new NotificationCompat.Builder(this) 
.SetContentTitle("This is content title") 


多 媒体 


.SetContentText("This is content text") 

.Setwhen(System.currentTimeMillis()) 

.SetSmallIcon(R.mipmap.ic launcher) 

.SetLargeIcon(BitmapFactory.decodeResource(getResources(), 
R.mipmap.ic launcher)) 


.SetContentIntent (pi) 
.build(); 
manager.notify(1, notification); 
break; 
default: 
break; 


} 


可 以 看 到 ,这 里 先是 使 用 Intent 表达 出 我 们 想 要 启动 NotificationActivity 的 “意图 ”， 然 后 将 
构建 好 的 Intent 对 象 传人 到 PendingIntent 的 oe () 方 法 里 , 以 得 到 PendingIntent 的 实 
例 ， 接 着 在 NotificationCompat.Builder 中 调用 setContentIntent() 方 法 ， 把 它 作 为 参数 
传人 即 可 。 

现在 重新 运行 一 下 程序 , 并 点 击 Send notice 按钮 ,依旧 会 发 出 一 条 通知 。 然 后 下 拉 系 统 状态 
栏 ， 点 击 一 下 该 通知 ， 就 会 看 到 NotificationActivity 这 个 活动 的 界面 了 ， 如 图 8.7 所 示 。 


a Wi B 7:45 


NotificationTest 


This is notification layout 


图 8.7 点 击 通 知 后 打开 NotificationActivity 界面 


号 ? 怎么 系统 状态 上 的 通知 图 标 还 没有 消失 呢 ? 是 这 样 的 ,如 果 我 们 没有 在 代码 中 对 该 通知 进 
行 取消 , 它 就 会 一 直 显 示 在 系统 的 状态 栏 上 。 解决 的 方法 有 两 种 , 一 种 是 在 NotificationCompat. 
Builder 中 再 连 绥 一 个 setAutoCancel() 方 法 ,一 种 是 显 式 地 调用 NotificationManager 的 
cancel() 方 法 将 它 取 消 ， 两 种 方法 我 们 都 学 习 一 下 。 
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第 一 种 方法 写法 如 下 : 


Notification notification = new NotificationCompat.Builder(this) 


.SetAutoCancel (true) 
.build(); 


可 以 看 到 ，setAutoCancel() 方 法 传人 true， 就 表示 当 点 击 了 这 个 通知 的 时 候 ， 通 知 会 自 
动 取消 掉 。 
第 二 种 方法 写法 如 下 : 


public class NotificationActivity extends AppCompatActivity { 


GOverride 
protected void onCreate(Bundle savedInstanceState) { 
super.onCreate(savedInstanceState); 
setContentView(R.layout.notification layout); 
NotificationManager manager = (NotificationManager) getSystemService 
(NOTIFICATION_ SERVICE); 
manager .cancel(1); 


} 

这 里 我 们 在 cancet() 方 法 中 传人 了 1， 这 个 1 是 什么 意思 呢 ? 还 记得 在 创建 通知 的 时 候 给 
每 条 通知 指定 的 id 吗 ? 当时 我 们 给 这 条 通知 设置 的 id 就 是 1。 因 此 ， 如 果 你 想 取消 哪 条 通知 ， 
在 cancel() 方 法 中 传人 该 通知 的 id 就 行 了 。 


8.2.2 ”通知 的 进 阶 技巧 


现在 你 已 经 掌握 了 创建 和 取消 通知 的 方法 , 并 且 知 道 了 如 何 去 响 应 通知 的 点 击 事件 。 不 过 通 
知 的 用 法 并 不 仅仅 是 这 些 呢 ， 下 面 我 们 就 来 探究 一 下 通知 的 更 多 技巧 。 

上 一 小 节 中 创建 的 通知 属于 最 基本 的 通知 ， 实 际 上 ，NotificationCompat.Builder 中 提 
供 了 非常 丰富 的 API 来 让 我 们 创建 出 更 加 多 样 的 通知 效果 。 当然, 每 一 个 API 都 详细 地 讲 一 遍 不 
太 可 能 ,我 们 只 能 从 中 选 一 些 比较 常用 的 API 来 进行 学 习 。 先 来 看 看 setSound ( ) 方 法 吧 ， 它 可 
以 在 通知 发 出 的 时 候 播放 一 段 音 频 ， 这 样 就 能 够 更 好 地 告知 用 户 有 通知 到 来 。setSound ( ) 方 法 
接收 一 个 Uri 参数 ， 所 以 在 指定 音频 文件 的 时 候 还 需要 先 获取 到 音频 文件 对 应 的 URI。 比 如 说 ， 
每 个 手机 的 /system/media/audio/ringtones 目录 下 都 有 很 多 的 音频 文件 ， 我 们 可 以 从 中 随便 选 一 个 
音频 文件 ， 那 么 在 代码 中 就 可 以 这 样 指定 ; 


Notification notification = new NotificationCompat.Builder(this) 


.SetSound(Uri.fromFiLe(new File("/system/media/audio/ringtones/Luna.ogg"))) 
.build(); 


除了 允许 播放 音频 外 ， 我 们 还 可 以 在 通知 到 来 的 时 候 让 手机 进行 振动 ， 使 用 的 是 vibrate 
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这 个 属性 。 它 是 一 个 长 整 型 的 数组 ， 用 于 设置 手机 静止 和 振动 的 时 长 ， 以 毫 秒 为 单位 。 下 标 为 0 
的 值 表示 手机 静止 的 时 长 , 下 标 为 1 的 值 表示 手机 振动 的 时 长 , 下 标 为 2 的 值 又 表示 手机 静止 的 
时 长 ， 以 此 类 推 。 所 以 ， 如果 想 要 让 手机 在 通知 到 来 的 时 候 立 刻 振 动 1 秒 ， 然后 静止 1 秒 ， 再 振 
动 1 秒 ， 代码 就 可 以 写成 : 


Notification notification = new NotificationCompat.Builder(this) 


.setVibrate (new Long[] {0, 1000, 1000, 1000 }) 
.build(); 
不 过 ， 想 要 控制 手机 振动 还 需要 声明 权限 。 因 此 ， 我 们 还 得 编辑 AndroidManifestxml 文件 ， 
加 入 如 下 声明 : 


<manifest xmlns:android="http://schemas.android.com/apk/res/android" 
package="com.example.notificationtest" 
android:versionCode="1" 
android:versionName="1.0" > 


uses Deriidsion android:name="android.permission.VIBRATE" /> 

</manifest> 

学 会 了 控制 通知 的 声音 和 振动 ， 下 面 我 们 来 看 一 下 如 何在 通知 到 来 时 控制 手机 LED 灯 的 
显示 。 

现在 的 手机 基本 上 都 会 前 置 一 个 LED 灯 ， 当 有 未 接 电话 或 未 读 短 信 ， 而 此 时 手机 又 处 于 锁 
屏 状 态 时 ，LED 灯 就 会 不 停 地 闪烁 ， 提 醒 用 户 去 查看 。 我 们 可 以 使 用 setLights () 方 法 来 实现 
这 种 效果 ，setLights() 方 法 接收 3 个 参数 ， 第 一 个 参数 用 于 指定 LED 灯 的 颜色 ， 第 二 个 参数 
用 于 指定 LED 灯亮 起 的 时 长 ， 以 毫秒 为 单位 ,第 三 个 参数 用 于 指定 LED 灯 暗 去 的 时 长 ， 也 是 以 
毫秒 为 单位 。 所 以 ， 当 通知 到 来 时 ， 如 果 想 要 实现 LED 灯 以 绿色 的 灯光 一 闪 一 闪 的 效果 ， 就 可 
以 写成 : 


Notification notification = new NotificationCompat.Builder(this) 


.SetLights(Color.GREEN, 1000, 1000) 
.build(); 


当然 如 果 你 不 想 进 行 那么 多 繁杂 的 设置 , 也 可 以 直接 使 用 通知 的 默认 效果 , 它 会 根据 当前 
手机 的 环境 来 决定 播放 什么 铃声 ， 以 及 如 何 振动 ， 写 法 如 下 : 


Notification notification = new NotificationCompat.Builder(this) 


.SetDefaults (NotificationCompat.DEFAULT_ALL) 
.build(); 


注意 , 以 上 所 涉及 的 这 些 进 阶 技巧 都 要 在 手机 上 运行 才能 看 得 到 效果 , 模拟 需 是 无 法 表现 出 
振动 以 及 LED 灯 闪 烁 等 功能 的 。 
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8.2.3 ”通知 的 高 级 功能 

继续 观察 NotificationCompat.Builder 这 个 类 ， 你 会 发 现 里 面 还 有 很 多 API 是 我 们 没有 
使 用 过 的 。 那 么 下 面 我 们 就 来 学 习 一 些 更 加 强大 的 API 的 用 法 ,从 而 构建 出 更 加 丰富 的 通知 效果 。 

先 来 看 看 setStyle() 方 法 ， 这 个 方法 允许 我 们 构建 出 富 文本 的 通知 内 容 。 也 就 是 说 通知 中 
不 光 可 以 有 文字 和 图 标 ， 还 可 以 包含 更 多 的 东西 。setStyle() 方 法 接收 一 个 Notification- 
Compat .Style 参数 ， 这 个 参数 就 是 用 来 构建 具体 的 寅 文本 信息 的 ， 如 长 文字 、 图 片 等 。 

在 开始 使 用 setStytLe( ) 方 法 之 前 ， 我 们 先 来 做 一 个 试验 吧 ， 之 前 的 通知 内 容 都 比较 短 ， 如 
果 设 置 成 很 长 的 文字 会 是 什么 效果 呢 ? 比如 这 样 写 : 


Notification notification = new NotificationCompat.Builder(this) 


.SetContentText("Learn how to build notifications, send and sync data, and use 
voice actions. Get the official Android IDE and developer tools to build 
apps for Android.") 

.build(); 


现在 重新 运行 程序 并 触发 通知 ， 效 果 如 图 8.8 所 示 。 


图 8.8 通知 内 容 文字 过 长 的 效果 
可 以 看 到 ， 通 知 内 容 是 无 法 显示 完整 的 ， 多 余 的 部 分 会 用 省 略 号 来 代替 。 其 实 这 也 很 正常 ， 
因为 通知 的 内 容 本 来 就 应 该 言 简 意 凡 ， 详 细 内 容 放 到 点 击 后 打开 的 活动 当中 会 更 加 合适 。 
但 是 如 果 你 真 的 非常 需要 在 通知 当中 显示 一 段 长 文字 ,Android 也 是 支持 的 ,通过 setStyle() 
方法 就 可 以 做 到 ， 有 具体 写法 如 下 : 


Notification notification = new NotificationCompat.Builder(this) 
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.SetStyle(new NotificationCompat.BigTextStyle().bigText("Learn how to build 
notifications, send and sync data, and use voice actions. Get the official 
Android IDE and developer tools to build apps for Android.")) 

.build(); 


我 们 在 setStyle() 方 法 中 创建 了 一 个 NotificationCompat.BigTextStyle 对 象 , 这 个 对 
象 就 是 用 于 封装 长 文字 信息 的 ， 我 们 调用 它 的 bigText () 方 法 并 将 文字 内 容 传人 就 可 以 了 。 

再 次 重新 运行 程序 并 触发 通知 ， 效 果 如 图 8.9 所 示 。 

除了 显示 长 文字 之 外 ， 通 知 里 还 可 以 显示 一 张大 图 片 ， 具 体 用 法 也 是 基本 相似 的 : 


Notification notification = new NotificationCompat.Builder(this) 


.SetStyle(new NotificationCompat.BigPictureStyle().bigPicture 
(BitmapFactory .decodeResource(getResources(), R.drawable.big image))) 
.build(); 


可 以 看 到 ， 这 里 仍然 是 调用 的 setStyle() 方 法 ， 这 次 我 们 在 参数 中 创建 了 一 个 
NotificationCompat .BigPictureStyle 对 象 ， 这 个 对 象 就 是 用 于 设置 大 图 片 的 ， 然 后 调用 它 
的 bigPicture() 方 法 并 将 图 片 传 人 。 这 里 我 事先 准备 好 了 一 张 图 片 ， 通 过 BitmapFactory 的 
decodeResource() 方 法 将 图 片 解析 成 Bitmap 对 象 ， 再 传人 到 bigPicture() 方 法 中 就 可 以 了 。 

现在 重新 运行 一 下 程序 并 触发 通知 ， 效 果 如 图 8.10 所 示 。 


This is content title 


图 8.9 通知 中 显示 长 文字 的 效果 图 8.10 通知 中 显示 大 图 片 的 效果 
这 样 我 们 就 把 setstyle() 方 法 中 的 重要 内 容 基 本 都 掌握 了 。 
接 下 来 再 学 习 一 下 setPriority() 方 法 , 它 可 以 用 于 设置 通知 的 重要 程度 。 setPriority() 
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方法 接收 一 个 整 型 参数 用 于 设置 这 条 通知 的 重要 程度 ， 一 共有 5 个 常量 值 可 选 : PRIORITY_ 
DEFAULT 表示 默认 的 重要 程度 ， 和 不 设置 效果 是 一 样 的 ;PRIORITY_MIN 表示 最 低 的 重要 程度 ， 
系统 可 能 只 会 在 特定 的 场景 才 显 示 这 条 通知 ， 比 如 用 户 下 拉 状 态 栏 的 时 候 ; PRIORITY_LOW 表示 
较 低 的 重要 程度 ， 系统 可 能 会 将 这 类 通知 缩小 , 或 改变 其 显示 的 顺序 , 将 其 排 在 更 重要 的 通知 之 
后 ; PRIORITY_HIGH 表示 较 高 的 重要 程度 ， 系 统 可 能 会 将 这 类 通知 放大 ,或 改变 其 显示 的 顺序 ， 
将 其 排 在 比较 靠 前 的 位 置 ; PRIORITY_MAX 表示 最 高 的 重要 程度 ， 这 类 通知 消息 必须 要 让 用 户 立 
刻 看 到 ， 甚 至 需要 用 户 做 出 响应 操作 。 具 体 写 法 如 下 : 


Notification notification = new NotificationCompat.Builder(this) 


.SetPriority(NotificationCompat.PRIORITY_MAX) 
.build(); 


这 里 我 们 将 通知 的 重要 程度 设置 成 了 最 高 ,表示 这 是 一 条 非常 重要 的 通知 , 要 求 用 户 必 须 立 
刻 看 到 。 现 在 重新 运行 一 下 程序 ， 并 点 击 Send notice 按钮 ， 效 果 如 图 8.11 所 示 。 


a oO | 


图 8.11 触发 一 条 重要 通知 


可 以 看 到 ， 这 次 的 通知 不 是 在 系统 状态 栏 显示 一 个 小 图 标 了 ， 而 是 弹出 了 一 个 横幅 ， 并 附 
带 了 通知 的 详细 内 容 ， 表 示 这 是 一 条 非常 重要 的 通知 。 不 管用 户 现在 是 在 玩 游戏 还 是 看 电影 ， 
这 条 通知 都 会 显示 在 最 上 方 ， 以 此 引起 用 户 的 注意 。 当 然 ， 使 用 这 类 通知 时 一 定 要 小 心 ， 确 保 
你 的 通知 内 容 的 确 是 至 关 重要 的 ,不 然 如 果 让 用 户 产生 反感 的 话 ， 很 可 能 会 导致 我 们 的 应 用 程 


8.3 调用 摄像 头 和 相册 
我 们 平时 在 使 用 QQ 或 微 信 的 时 候 经 常 要 和 别人 分 享 图 片 , 这 些 图 片 可 以 是 用 手机 摄像 头 拍 
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的 ,也 可 以 是 从 相册 中 选取 的 。 类 似 这 样 的 功能 实在 是 大 常见 了 , 几乎 在 每 一 个 应 用 程序 中 都 会 
有 ， 那 么 本 节 我 们 就 学 习 一 下 调用 摄像 头 和 相册 方面 的 知识 。 


8.3.1 调用 摄像 头 拍照 


先 来 看 看 摄像 头 方面 的 知识 , 现在 很 多 的 应 ee 这 时 
打开 摄像 头 拍 张 照 是 最 简单 快捷 的 。 下 面 就 让 我 们 通过 一 个 例子 来 学 习 一 下 , 如何 才能 在 应 用 程 
序 里 调用 手机 的 摄像 头 进行 拍照 。 


新 建 一 个 CameraAlbumTest 项目 ， 然 后 修改 activity _ main.xml 中 的 代码 ， 如 下 所 示 : 


<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:orientation="vertical" 
android:layout width="match parent" 
android:layout height="match parent" > 


<Button 
android:id="@+id/take photo" 
android:layout width="match parent" 
android:layout height="wrap content" 
android:text="Take Photo" /> 


<ImageView 
android:id="@+id/picture" 
android:layout width="wrap content" 
android:layout height="wrap content" 
android:layout gravity="center horizontal" /> 


</LinearLayout> 


可 以 看 到 , 布局 文件 中 只 有 两 个 控件 ,一 个 Button 和 一 个 ImageView。Button 是 用 于 打开 摄 
像 头 进行 拍照 的 ， 而 ImageView 则 是 用 于 将 拍 到 的 图 片 显示 出 来 。 


然后 开始 编写 调用 摄像 头 的 具体 逻辑 ， 修 改 MainActivity 中 的 代码 ， 如 下 所 示 : 


public cLass MainActivity extends AppCompatActivity { 


public static final int TAKE PHOTO = 1; 
private ImageView picture; 
private Uri imageUri; 


@Override 

protected void onCreate(Bundle savedInstanceState) { 
super.onCreate(savedInstanceState); 
setContentView(R.layout.activity main); 
Button takePhoto = (Button) findViewById(R.id.take photo); 
picture = (ImageView) findViewById(R.id.picture); 
takePhoto.setOnClickListener(new View.OnClickListener() { 

@Override 
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public void onClick(View v) { 
// 创建 FiLe 对 象 ， 用 于 存储 拍照 后 的 


图 片 


File outputImage = new File(getExternalCacheDir(), 


"output image.jpg"); 
try { 
if (outputImage.exists() ) 
outputImage.delete(); 
} 


{ 


outputImage.createNewFile(); 


} catch (IOException e) { 
e.printStackTrace(); 
} 


if (Build.VERSION.SDK INT >= 24) { 


imageUri = FileProvider.getUriForFile(MainActivity.this, 


"com.example.cameraalbumtest.fileprovider", outputImage); 


} else { 


imageUri = Uri.fromFile(outputImage); 


; 
// 启动 相机 程序 


Intent intent = new Intent("android,.media.action.IMAGE CAPTURE"); 
intent.putExtra(MediaStore.EXTRA OUTPUT, imageUri); 
startActivityForResult(intent, TAKE PHOTO); 


}); 
} 


GOverride 


protected void onActivityResult(int requestCode, int resultCode, Intent data) { 


switch (requestCode) { 
case TAKE PHOTO: 


if (resultCode == RESULT OK) { 


try { 
// 将 拍摄 的 照片 显示 出 来 


Bitmap bitmap = BitmapFactory.decodeStream(getContent- 
Resolver().openInputStream(imageUri)); 
picture.setImageBitmap(bitmap); 

} catch (FileNotFoundException e) { 


e.printStackTrace(); 
} 
} 
break; 
default: 
break; 


} 


上 述 代码 稍微 有 点 复杂 , 我 们 来 仔细 地 分 析 一 下 。 在 MainActivity 中 要 做 的 第 一 件 事 自然 
分 别 获 取 到 Button 和 ImageView 的 实例 ， 并 给 Button 注册 上 点 击 事 价 
件 里 开始 处 理 调用 摄像 头 的 逻辑 ， 我 们 重点 看 一 下 这 部 分 代码 。 


FE， 然后 在 Button 了 


点 击 


旭 
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首先 这 里 创建 了 一 个 File 对 象 ,用 于 存放 摄像 头 拍 下 的 图 片 ,这 里 我 们 把 图 片 命名 为 output_ 
image.jpg， 并 将 它 存 放 在 手机 SD 卡 的 应 用 关联 缓存 目录 下 。 什 么 叫 作 应 用 关联 缓存 目录 呢 ?” 就 
是 指 SD 卡 中 专门 用 于 存放 当前 应 用 缓存 数据 的 位 置 ， 调 用 getExternalCacheDir() 方 法 可 以 
得 到 这 个 目录 ， 具 体 的 路 径 是 /sdcard/Android/data/<package name>/cache。 那 么 为 什么 要 使 用 应 用 
关联 组 目录 来 存放 图 片 呢 ? 因为 从 Android 6.0 系统 开始 , 读 写 SD 卡 被 列 为 了 和 危险 权限 ， 如 果 将 
图 片 存放 在 SD 卡 的 任何 其 他 目录 ， 都 要 进行 运行 时 权限 处 理 才 行 ， 而 使 用 应 用 关联 目录 则 可 以 
跳 过 这 一 步 。 

接着 会 进行 一 个 判断 , 如 果 运 行 设 备 的 系统 版 本 低 于 Android 7.0, 就 调用 Uri 的 fromFile() 
方法 将 File 对 象 转换 成 Uri 对 象 , 这 个 Uri 对 象 标 识 着 output_image.jpg 这 张 图 片 的 本 地 真实 路 
径 。 和 否则， 就 调用 FileProvider 的 getUriForFile() 方 法 将 File 对 象 转换 成 一 个 封装 过 的 Uri 
对 象 。getUriForFile() 方 法 接收 3 个 参数 ， 第 一 个 参数 要 求 传人 Context 对 象 ， 第 二 个 参数 
可 以 是 任意 唯一 的 字符 串 ， 第 三 个 参数 则 是 我 们 刚刚 创建 的 FiLe 对 象 。 之 所 以 要 进行 这 样 一 层 
转换 ,是 因为 从 Android 7.0 系统 开始 , 直接 使 用 本 地 真实 路 径 的 Uri 被 认为 是 不 安全 的 ,会 抛 出 
一 个 FileUriExposedException 异常 。 而 FileProvider 则 是 一 种 特殊 的 内 容 提供 器 ， 它 使 用 了 和 内 
容 提 供 器 类 似 的 机 制 来 对 数据 进行 保护 ， 可 以 选择 性 地 将 封装 过 的 Uri 共享 给 外 部 ， 从 而 提高 了 
应 用 的 安全 性 。 

接 下 来 构建 出 了 一 个 Intent 对 象 ， 并 将 这 个 Intent 的 action 指定 为 android.media. 
action.IMAGE_CAPTURE， 再 调用 Intent 的 putExtra() 方 法 指定 图 片 的 输出 地 址 ， 这 里 填 和 人 
刚刚 得 到 的 Uri 对 象 , 最 后 调用 startActivityForResutLt () 来 启动 活动 。 由 于 我 们 使 用 的 是 一 
个 隐 式 Intent， 系 统 会 找 出 能 够 响应 这 个 Intent 的 活动 去 启动 ， 这 样 照相 机 程序 就 会 被 打开 ， 拍 
下 的 照片 将 会 输出 到 output_image.jpg 中 。 


注意 ， 刚 才 我 们 是 使 用 startActivityForResult() 来 启动 活动 的 ， 因 此 拍 完 照 后 会 有 结 
果 返 回 到 onActivityResult() 方 法 中 。 如 果 发 现 拍 照 成 功 ， 就 可 以 调用 BitmapFactory 的 
decodeStream() 方 法 将 output_image.jpg 这 张 照片 解析 成 Bitmap 对 象 , 然后 把 它 设 置 到 Image- 
View 中 显示 出 来 。 


不 过 现在 还 没 结 束 , 刚才 提 到 了 内 容 提供 器 , 那么 我 们 自然 要 在 AndroidManifest.xml 中 对 内 
容 提供 器 进行 注册 了 ， 如 下 所 示 


<manifest xmlns:android="http://schemas.android.com/apk/res/android" 
package="com.example.cameraalbumtest"> 
<application 
android:allowBackup="true" 
android:icon="@mipmap/ic launcher" 
android:label="@string/app_name" 
android:supportsRtl="true" 
android:theme="@style/AppTheme"> 


<provider 
android:name="android.support.v4.content.FileProvider" 
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android:authorities="com.example.cameraalbumtest.fileprovider" 
android:exported="false" 
android:grantUriPermissions="true"> 
<meta-data 
android:name="android.support,FILE_PROVIDER_PATHS" 
android: resource="@xml/file paths" /> 
</provider> 
</application> 
</manifest> 
其 中 ，android:name 属性 的 值 是 固定 的 ，android:authorities 属性 的 值 必 须要 和 刚才 
FiLeProvider.getUriForFite(I) 方 法 中 的 第 二 个 参数 一 致 。 另 外 ， 这 里 还 在 <provider> 标 签 
的 内 部 使 用 <meta-data> 来 指定 Uri 的 共享 路 径 , 并 引用 了 一 个 @xmL/file_paths 资源 。 当 然 ， 
这 个 资源 现在 还 是 不 存在 的 ， 下 面 我 们 就 来 创建 它 。 
右 击 res 目录 一 New 一 Directory， 创 建 一 个 xml 目录 ， 接 着 右 击 xml 目录 一 New 一 File， 创 
建 一 个 file_paths.xml 文件 。 然 后 修改 file_paths.xml 文件 中 的 内 容 ， 如 下 所 示 : 
<?xml version="1.0" encoding="utf-8"?> 
<paths xmlns:android="http://schemas.android.com/apk/res/android"> 
<external-path name="my_ images" path="" /> 
</paths> 
其 中 ，external-path 就 是 用 来 指定 Uri 共享 的 ，name 属性 的 值 可 以 随便 填 ，path 属性 
的 值 表示 共享 的 具体 路 径 。 这 里 设置 空 值 就 表示 将 整个 SD 卡 进行 共享 ， 当 然 你 也 可 以 仅 共享 我 
们 存放 output image.jpg 这 张 图 片 的 路 径 。 


另外 还 有 一 点 要 注意 , 在 Android4.4 系统 之 前 , 访问 SD 卡 的 应 用 关联 目录 也 是 要 声明 权限 
的 ， 从 4.4 系统 开始 不 再 需要 权限 声明 。 那 么 我 们 为 了 能 够 兼容 老 版 本 系统 的 手机 ， 还 需要 在 
AndroidManifestxml 中 声明 一 下 访问 SD 卡 的 权限 : 

<manifest xmlns:android="http://schemas.android.com/apk/res/android" 


package="com.example.cameraalbumtest"> 
<uses-permission android:name="android.permission.WRITE EXTERNAL_ STORAGE" /> 


</manifest> 

这 样 代码 就 都 编写 完了 ,现在 将 程序 运行 到 手机 上 , 然后 点 击 Take Photo 按钮 就 可 以 进行 拍 
照 了 ， 如 图 8.12 所 示 。 拍 照 完 成 后 ， 点 击 中 间 按 钮 就 会 回 到 我 们 程序 的 界面 。 同 时 ， 拍 摄 的 照 
片 也 会 显示 出 来 了 ， 如 图 8.13 所 示 。 
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图 8.12 ”打开 摄像 头 拍照 


8.3.2 ”从 相册 中 选择 照片 


4 20:51 


CameraAlbumTest 


TAKE PHOTO 


图 8.13 ”拍照 的 最 终 效 果 


虽然 调用 摄像 头 拍 照 既 方 便 又 快 扣 


E, 但 我 们 并 不 是 每 次 都 需要 去 当场 拍 一 张 照 片 的 。 因为 每 


个 人 的 手机 相册 里 应 该 都 会 在 有 许 许多 多 张 照片 ,直接 从 相册 里 选取 一 张 现 有 的 照片 会 比 打开 
相机 拍 一 张 照片 更 加 常用 。 一 个 优秀 的 应 用 程序 应 该 将 这 两 种 选择 方式 都 提供 给 用 户 , 由 用 户 来 
决定 使 用 哪 一 种 。 下 面 我 们 就 来 看 一 下 ， 如 何 才 能 实现 从 相册 中 选择 照片 的 功能 。 

还 是 在 CameraAlbumTest 项 目的 基础 上 进行 修改 ， 编 辑 activity_main.xml 文件 ， 在 布局 中 添 
加 一 个 按钮 用 于 从 相册 中 选择 照片 ， 代 码 如 下 所 示 : 


<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 


android:orientation="verti 
android:layout width="matc 
android:layout height="mat 


<Button 
android:id="@+id/take 


cal" 
h_parent" 
ch_parent" > 


photo" 


android:layout width="match parent" 


android:layout height= 


"wrap_content" 


android:text="Take Photo" /> 


<Button 
android:id="@+id/choos 


e_from_ album" 


android:layout width="match_ parent" 


android:Layout_height= 
android:text="Choose F 


<ImageView 
android:id="@+id/pictu 


"wrap_content" 
rom Album" /> 


re" 
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android:Layout width="wrap_ content" 
android:layout height="wrap content" 
android:layout gravity="center horizontal" /> 


</LinearLayout> 


然后 修改 MainActivity 中 的 代码 ， 加 入 从 相册 选择 照片 的 逻辑 ， 代 码 如 下 所 示 : 


public class MainActivity extends AppCompatActivity { 


public static final int CHOOSE PHOTO = 2; 


@Override 

protected void onCreate(Bundle savedInstanceState) { 
super.onCreate(savedInstanceState); 
SetContentView(R.Layout.activity main); 
Button takePhoto = (Button) findViewById(R.id.take photo); 
Button chooseFromAlbum = (Button) findViewById(R.id.choose from album); 


chooseFromAlbum.setOnClickListener(new View.0nCLickListener() { 
@Override 
public void onClick(View v) { 
if (ContextCompat.checkSelfPermission(MainActivity.this, 
Manifest.permission.WRITE EXTERNAL STORAGE) != PackageManager. 
PERMISSION GRANTED) { 
ActivityCompat. requestPermissions (MainActivity.this, new 
String[]{ Manifest.permission. WRITE EXTERNAL STORAGE }, 1); 
} else{ 
openALbum() ; 
} 


}); 
} 


private void openAlbum() { 
Intent intent = new Intent("android.intent.action.GET CONTENT"); 
intent.setType("image/*"); 
startActivityForResult(intent, CHOOSE PHOT0); // 打开 相册 

} 


@Override 
public void onRequestPermissionsResult(int requestCode, String[] permissions, 
int[] grantResults) { 
switch (requestCode) { 
case 1: 
if (grantResuLts.Length > 0 && grantResuLts[0] == PackageManager. 
PERMISSION GRANTED) { 
openALbum() ; 
} elLse { 
Toast .makeText (this，"You denied the permission", 
Toast .LENGTH_SHORT) .show() ; 
} 


break; 
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default: 


} 


@Override 


protected void onActivityResult(int requestCode, int resultCode, Intent data) { 
switch (requestCode) { 


case CHOOSE PHOTO: 
if (resultCode == RESULT OK) { 

// 判断 手机 系统 版 本 号 

if (Build.VERSION.SDK INT >= 19) { 
// 4.4 及 以 上 系统 使 用 这 个 方法 处 理 图 片 
handleImageOnKitKat (data); 

} else { 
// 4.4 以 下 系统 使 用 这 个 方法 处 理 图 片 
handleImageBeforeKitKat (data); 


} 
} 
break; 
default: 
break; 
} 
} 
@TargetApi(19) 


private void handleImageOnKitKat(Intent data) { 
String imagePath = null; 
Uri uri = data.getData(); 
if (DocumentsContract.isDocumentUri(this, uri)) { 
// 如 果 是 document 类 型 的 Uri， 则 通过 document id 处 理 
String docId = DocumentsContract.getDocumentId(uri); 
if("com.android.providers.media.documents" .equals(uri.getAuthority())) { 
String id = docId.split(":")[1]; // 解析 出 数字 格式 的 id 
String selection = MediaStore.Images.Media. ID + "=" + id; 
imagePath = getImagePath (MediaStore.Images.Media.EXTERNAL 
CONTENT_URI, selection); 
} else if ("com.android.providers.downloads.documents".equals(uri. 
getAuthority())) { 
Uri contentUri = ContentUris.withAppendedId(Uri.parse("content: 
//downloads/public downloads"), Long.valueO0f(docId)); 
imagePath = getImagePath(contentUri, null); 
} 
} else if ("content".equalsIgnoreCase(uri.getScheme())) { 
// 如 果 是 content 类 型 的 Uri， 则 使 用 普通 方式 处 理 
imagePath = getImagePath(uri, null); 
} else if ("file".equalsIgnoreCase(uri.getScheme())) { 
// 如 果 是 file 类 型 的 Uri， 直 接 获 取 图 片 路 径 即 可 
imagePath = uri.getPath(); 
} 
displayImage(imagePath); // 根据 图 片 路 径 显 示 图 片 
} 


private void handleImageBeforeKitKat(Intent data) { 
Uri uri = data.getData(); 
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String imagePath = getImagePath(uri, null); 
displayImage(imagePath); 
} 


private String getImagePath(Uri uri, String selection) { 

String path = null; 
// 通过 Uri 和 selection 来 获取 真实 的 图 片 路 径 
Cursor cursor = getContentResolver().query(uri, null, selection, null, null); 
if (cursor != nuLL) { 

if (cursor.moveToFirst()) { 

path = cursor.getString(cursor.getColumnIndex (MediaStore. 
Images .Media.DATA)); 
} 


cursor.close(); 


} 
return path; 


} 


private void displayImage(String imagePath) { 
if (imagePath != null) { 
Bitmap bitmap = BitmapFactory.decodeFile(imagePath); 
picture.setImageBitmap (bitmap); 
} else { 
Toast.makeText(this, "failed to get image", Toast.LENGTH SHORT).show(); 
} 


} 


可 以 看 到 ， 在 Choose From Album 按钮 的 点 击 事件 里 我 们 先是 进行 了 一 个 运行 时 权限 处 理 ， 
动态 申请 WRITE_EXTERNAL_STORAGE 这 个 危险 权限 。 为 什么 需要 申请 这 个 权限 呢 ? 因为 相册 中 
的 照片 都 是 存储 在 SD 卡 上 的 ， 我 们 要 从 SD 卡 中 读 取 照片 就 需要 申请 这 个 权限 。WRITE_ 
EXTERNAL_STORAGE 表示 同时 授予 程序 对 SD 卡 读 和 写 的 能 力 。 

当 用 户 授 权 了 权限 申请 之 后 会 调用 openALbum( ) 方 法 ， 这 里 我 们 先是 构建 出 了 一 个 Intent 
对 象 ， 并 将 它 的 action 指定 为 android.intent.action.GET_ CONTENT。 接 着 给 这 个 Intent 
对 象 设置 一 些 必要 的 参数 ， 然 后 调用 startActivityForResult() 方 法 就 可 以 打开 相册 程序 选 
择 照片 了 。 注 意 在 调用 startActivityForResutLt () 方 法 的 时 候 ， 我 们 给 第 二 个 参数 传人 的 值 
变 成 了 CH00SE_PH0T0， 这 样 当 从 相册 选择 完 图 片 回 到 onActivityResutLt () 方 法 时 ， 就 会 进入 
CH00SE_PH0T0 的 case 来 处 理 图 片 。 接 下 来 的 逻辑 就 比较 复杂 了 ， 首 先 为 了 兼容 新 老 版 本 的 手 
机 ， 我 们 做 了 一 个 判断 ， 如 果 是 4.4 及 以 上 系统 的 手机 就 调用 handleImage0nKitKat() 方 法 来 
处 理 图 片 ， 否 则 就 调用 handleImageBeforeKitKat() 方 法 来 处 理 图 片 。 之 所 以 要 这 样 做 ， 是 因 
为 Android 系统 从 4.4 版 本 开始 ， 选 取 相 册 中 的 图 片 不 再 返回 图 片 真实 的 Uri 了 ， 而 是 一 个 封装 
过 的 Uri， 因 此 如 果 是 4.4 版 本 以 上 的 手机 就 需要 对 这 个 Uri 进行 解析 才 行 。 

那么 handLeImage0nKitKat () 方 法 中 的 逻辑 就 基本 是 如 何 解 析 这 个 封装 过 的 Uri 了 。 这 里 
有 好 几 种 判断 情况 ， 如 果 返 回 的 Uri 是 document 类 型 的 话 ， 那 就 取出 document id 进行 处 理 ， 
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如 果 不 是 的 话 , 那 就 使 用 普通 的 方式 处 理 。 另 外 ,如 果 Uri 的 authority 是 media 格 式 的 话 ,document 
id 还 需要 再 进行 一 次 解析 ， 要 通过 字符 串 分 割 的 方式 取出 后 半 部 分 才能 得 到 真正 的 数字 id。 取 
出 的 id 用 于 构建 新 的 Uri 和 条 件 语句 ,然后 把 这 些 值 作为 参数 传人 到 getImagePath ( ) 方 法 当中 ， 
就 可 以 获取 到 图 片 的 真实 路 径 了 。 拿 到 图 片 的 路 径 之 后 ， 再 调用 dispLayImage( ) 方 法 将 图 片 显 
示 到 界面 上 。 

相 比 于 handleImage0nKitKat() 方 法 ，handleImageBeforeKitKat() 方 法 中 的 逻辑 就 要 
简单 得 多 了 ,因为 它 的 Uri 是 没有 封装 过 的 ,不 需要 任何 解析 ,直接 将 Uri 传人 到 getImagePath() 
方法 当中 就 能 获取 到 图 片 的 真实 路 径 了 , 最 后 同样 是 调用 displayImage() 方 法 来 让 图 片 显示 到 
界面 上 。 

现在 将 程序 重新 运行 到 手机 上 ， 然后 点 击 一 下 Choose From Album 按钮 ， 首 先 会 弹出 权限 申 
请 框 ， 如 图 8.14 所 示 。 


点 击 允 许 之 后 就 会 打开 手机 相册 ， 如 图 8.15 所 示 。 
然后 随意 选择 一 张 照 片 ， 回 到 我 们 程序 的 界面 ,选中 的 照片 应 该 就 会 显示 出 来 了 ,如 图 8.16 


所 示 。 
用 兽 23:51 
CameraAlbumTest 


TAKE PHOTO 


ol 


CHOOSE FROM ALBUM 


要 允许 
CameraAlbumTest 访 问 
您 设备 上 的 照片 、 媒 体 
内 容 和 文件 吗 ? 


拒绝 允许 


图 8.14 ”申请 访问 SD 卡 权限 图 8.15 ”打开 手机 相册 图 8.16 选择 照片 的 最 终 效 果 


调用 摄像 头 拍照 以 及 从 相册 中 选择 照片 是 很 多 Android 应 用 都 会 带 有 的 功能 , 现在 你 已 经 将 
这 两 种 技术 都 学 会 了 , 将 来 在 工作 中 如 果 需 要 开发 类 似 的 功能 ,相信 你 一 定 能 轻松 完成 的 。 不 过 
目前 我 们 的 实现 还 不 算 完 美 , 因为 某 些 照片 即使 经 过 裁剪 后 体积 仍然 很 大 , 直接 加 载 到 内 存 中 有 
可 能 会 导致 程序 崩溃 。 更 好 的 做 法 是 根据 项 目的 需求 先 对 照片 进行 适当 的 压缩 ,然后 再 加 载 到 内 
存 中 。 至 于 如 何 对 照片 进行 压缩 ， 就 要 考验 你 查阅 资料 的 能 力 了 ， 这 里 就 不 再 展开 进行 讲解 了 。 
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8.4 播放 多 媒体 文件 


手机 上 最 常见 的 休闲 方式 毫 无 疑问 就 是 听 音 乐 和 看 电影 了 , 随 着 移动 设备 的 普及 , 越 来 越 多 
的 人 都 可 以 随时 享受 优美 的 音乐 ， 以 及 观看 精彩 的 电影 。 而 Android 在 播放 音频 和 视频 方面 也 是 
做 了 相当 不 错 的 支持 ， 它 提供 了 一 套 较 为 完整 的 API， 使 得 开发 者 可 以 很 轻松 地 编写 出 一 个 简易 
的 音频 或 视频 播放 器 ， 下 面 我 们 就 来 具体 地 学 习 一 下 。 


8.4.1 播放 音频 


在 Android 中 播放 音频 文件 一 般 都 是 使 用 MediaPLayer 类 来 实现 的 ， 它 对 多 种 格式 的 音频 
文件 提供 了 非常 全 面 的 控制 方法 ， 从 而 使 得 播放 音乐 的 工作 变 得 十 分 简单 。 下 表 列 出 了 
MediaPlayer 类 中 一 些 较 为 常用 的 控制 方法 。 


方法 名 功能 描述 
setDataSource() 设置 要 播放 的 音频 文件 的 位 置 
prepare() 在 开始 播放 之 前 调用 这 个 方法 完成 准备 工作 
start() 开始 或 继续 播放 音频 
pause() 暂停 播放 音频 
reset () 将 MediaPlayer 对 象 重 置 到 刚刚 创建 的 状态 
seekTo() 从 指定 的 位 置 开始 播放 音频 
stop() 停止 播放 音频 。 调 用 这 个 方法 后 的 MediaPlayer 对 象 无 法 再 播放 音频 
release() 释放 掉 与 MediaPlayer 对 象 相关 的 资源 
isPLaying() 判断 当前 MediaPlayer 是 否 正在 播放 音频 
getDuration() 获取 载 入 的 音频 文件 的 时 长 


简单 了 解 了 上 述 方 法 后 ， 我 们 再 来 梳理 一 下 MediaPlayer 的 工作 流程 。 首 先 需要 创建 出 一 
个 MediaPlayer 对 象 ， 然 后 调用 setDataSource() 方 法 来 设置 音频 文件 的 路 径 ， 再 调用 
prepare() 方 法 使 MediaPLayer 进入 到 准备 状态 ， 接 下 来 调用 start() 方 法 就 可 以 开始 播放 音 
频 ， 调 用 pause() 方 法 就 会 暂停 播放 ， 调 用 reset ( ) 方 法 就 会 停止 播放 。 

下 面 就 让 我 们 通过 一 个 具体 的 例子 来 学 习 一 下 吧 ， 新 建 一 个 PlayAudioTest 项 目 ， 然 后 修改 
activity_main.xml 中 的 代码 ， 如 下 所 示 : 


<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:orientation="vertical" 
android:layout width="match parent" 
android:layout height="match parent" > 


<Button 
android:id="@+id/play" 
android:layout width="match parent" 
android:layout height="wrap content" 
android:text="Play" /> 
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<Button 
android:id="@+id/pause" 
android:layout width="match parent" 
android:layout height="wrap_ content" 
android:text="Pause" /> 


<Button 
android:id="@+id/stop" 
android:layout width="match parent" 
android:layout height="wrap content" 
android:text="Stop" /> 


</LinearLayout> 


布局 文件 中 放置 了 3 个 按钮 ， 分 别 用 于 对 音频 文件 进行 播放 、 和 暂停 和 停止 操作 。 然 后 修改 
MainActivity 中 的 代码 ， 如 下 所 示 : 
public class MainActivity extends AppCompatActivity impLements View.OnClickListenert{ 


private MediaPLayer mediaPLayer = new MediaPlayer(); 


@Override 
protected void onCreate(Bundle savedInstanceState) { 
super.onCreate(savedInstanceState), 
setContentView(R.layout.activity main); 
Button play = (Button) findViewById(R.id.play); 
Button pause = (Button) findViewById(R.id.pause); 
Button stop = (Button) findViewById(R.id.stop); 
play.setOnClickListener(this); 
pause.setOnClickListener(this); 
stop.setOnClickListener(this); 
if (ContextCompat.checkSelfPermission(MainActivity.this, Manifest. permission. 
WRITE EXTERNAL STORAGE) != PackageManager.PERMISSION GRANTED) { 
ActivityCompat.requestPermissions (MainActivity.this, new String[]{ 
Manifest.permission. WRITE EXTERNAL STORAGE }, 1); 
} else { 
initMediaPLayer(); // 初始 化 MediaPlayer 
} 
} 


private void initMediaPLayer() { 
try { 
File file = new File(Environment.getExternalStorageDirectory(), 
"music.mp3"); 
mediaPlayer.setDataSource(file.getPath()); // 指定 音频 文件 的 路 径 
mediaPlayer.prepare(); // 让 MediaPLayer 进入 到 准备 状态 
} catch (Exception e) { 
e.printStackTrace(); 
} 
} 


@Override 
public void onRequestPermissionsResult(int requestCode, String[] permissions, 
int[] grantResults) { 
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switch (requestCode) { 


case 1: 
if (grantResults.length > 0 && grantResults[0] == PackageManager. 


PERMISSION GRANTED) { 
initMediaPlayer(); 


} else { 
Toast.makeText(this，,， "拒绝 权限 将 无 法 使 用 程序 "， 


Toast.LENGTH SHORT).show(); 


finish(); 
} 
break; 
default: 
} 
} 
GOverride 


public void onClick(View v) { 
switch (v.getId()) { 
case R.id.play: 
if (!mediaPLayer.isPLaying()) { 
mediaPlayer.start(); // 开始 播放 
} 
break ; 
case R.id.pause: 
if (mediaPLayer.isPLaying()) { 
mediaPlayer.pause(); // 暂停 播放 
} 
break ; 
case R.id.stop: 
if (mediaPLayer.isPLaying()) { 
mediaPLayer.reset(); // 停止 播放 
initMediaPlayer(); 


} 
break; 
default: 
break; 
} 
} 
GOverride 


protected void onDestroy() { 
super.onDestroy(); 
if (mediaPlayer != null) { 
mediaPlayer. stop(); 
mediaPlayer.release(); 


} 

可 以 看 到 , 在 类 初始 化 的 时 候 我 们 就 先 创 建 了 一 个 MediaPlayer 的 实例 , 然后 在 onCreate() 
方法 中 进行 了 运行 时 权限 处 理 ， 动 态 申请 WRITE_EXTERNAL STORAGE 权限 。 这 是 由 于 待 会 我 们 
会 在 SD 卡 中 放置 一 个 音频 文件 ， 程 序 为 了 播放 这 个 音频 文件 必须 拥有 访问 SD 卡 的 权限 才 行 。 
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注意 ,在 onRequestPermissionsResutLt () 方 法 中 ， 如 果 用 户 拒绝 了 权限 申请 ， 那 么 就 调用 
finish() 方 法 将 程序 直接 关 掉 ,因为 如 果 没 有 SD 卡 的 访问 权限 ,我 们 这 个 程序 将 什么 都 干 不 了 。 


用 户 同意 授权 之 后 就 会 调用 initMediaPlayer() 方 法 为 MediaPlayer 对 象 进行 初始 化 操 
作 。 在 initMediaPlayer() 方 法 中 , 首先 是 通过 创建 一 个 File 对 象 来 指定 音频 文件 的 路 径 , 从 
这 里 可 以 看 出 ， 我 们 需要 事先 在 SD 卡 的 根 目录 下 放置 一 个 名 为 music.mp3 的 音频 文件 。 后 面 依 
次 调用 了 setDataSource() 方 法 和 prepare() 方 法 ， 为 MediaPlayer 做 好 了 播放 前 的 准备 。 


接 下 来 我 们 看 一 下 各 个 按钮 的 点 击 事件 中 的 代码 。 当 点 击 Play 按钮 时 会 进行 判断 ， 如 果 当 
前 MediaPlayer 没有 正在 播放 音频 ， 则 调用 start() 方 法 开始 播放 。 当 点 击 Pause 按钮 时 会 判断 ， 
如 果 当 前 MediaPlayer 正在 播放 音频 , 则 调用 pause( ) 方 法 暂停 播放 。 当 点 击 Stop 按钮 时 会 判断 ， 
如 果 当 前 MediaPlayer 正 在 播放 音频 , 则 调用 reset () 方 法 将 MediaPlayer 重 置 为 刚刚 创建 的 状态 ， 
然后 重新 调用 一 遍 initMediaPLayer() 方 法 。 

最 后 在 onDestroy () 方 法 中 ， 我 们 还 需要 分 别 调用 stop () 方 法 和 release() 方 法 ,将 与 
MediaPlayer 相关 的 资源 释放 掉 。 

另外 ， 千 万 不 要 忘记 在 AndroidManifestxml 文件 中 声明 用 到 的 权限 ， 如 下 所 示 : 

<manifest xmlns:android="http://schemas.android.com/apk/res/android" 


package="com.example.playaudiotest"> 
<uses-permission android:name="android.permission.WRITE EXTERNAL STORAGE" /> 


</manifest> 


这 样 一 个 简易 版 的 音乐 播放 器 就 完成 了 , 现在 将 程序 运行 到 手机 上 会 先 弹出 权限 申请 框 ， 如 
图 8.17 所 示 。 


要 允许 PlayAudioTest 访 
问 您 设备 上 的 照片 、 媒 
体内 容 和 文件 吗 ? 


拒绝 允许 


图 8.17 音乐 播放 器 主 界面 
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同意 授权 之 后 就 可 以 开始 播放 音乐 了 ， 点 击 一 下 Play 按钮 ， 优 美的 音乐 就 会 响起 ， 然 后 点 
击 Pause 按钮 ， 音 乐 就 会 停 住 ,再 次 点 击 Play 按钮 ， 会 接着 暂停 之 前 的 位 置 继续 播放 。 这 时 如 果 
点 击 一 下 Stop 按钮 ,音乐 也 会 停 住 ,但 是 当 再 次 点 击 Play 按钮 时 ， 音 乐 就 会 从 头 开始 播放 了 。 


8.4.2 播放 视频 

播放 视频 文件 其 实 并 不 比 播放 音频 文件 复杂 ， 主 要 是 使 用 VideoView 类 来 实现 的 。 这 个 类 将 
视频 的 显示 和 控制 集 于 一 身 , 使 得 我 们 仅仅 借助 它 就 可 以 完成 一 个 简易 的 视频 播放 器 。 VideoView 
的 用 法 和 MediaPlayer 也 比较 类 似 ， 主 要 有 以 下 常用 方法 : 


方 法 名 功能 描述 
setVideopath() 设置 要 播放 的 视频 文件 的 位 置 
start() 开始 或 继续 播放 视频 
pause() 暂停 播放 视频 
resume() 将 视频 重头 开始 播放 
seekTo() 从 指定 的 位 置 开始 播放 视频 
isPLaying() 判断 当前 是 否 正在 播放 视频 
getDuration() 获取 载 入 的 视频 文件 的 时 长 


那么 我 们 还 是 通过 一 个 实际 的 例子 来 学 习 一 下 吧 ， 新 建 PlayVideoTest 项 目 ， 然 后 修改 
activity_main.xml 中 的 代码 ， 如 下 所 示 : 


<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:orientation="vertical" 
android:layout width="match parent" 
android:layout height="match parent" > 


<LinearLayout 
android:layout width="match parent" 
android:layout height="wrap content" > 


<Button 
android:id="@+id/play" 
android:layout width="0dp" 
android:layout height="wrap content" 
android:layout weight="1" 
android:text="Play" /> 


<Button 
android:id="@+id/pause" 
android:layout width="0dp" 
android:layout height="wrap content" 
android:layout weight="1" 
android:text="Pause" /> 


<Button 
android:id="@+id/replay" 
android:layout width="0dp" 
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android:layout height="wrap content" 
android:layout weight="1" 
android:text="Replay" /> 


</LinearLayout> 


<VideoView 
android:id="@+id/video view" 
android:layout width="match parent" 
android:layout height="wrap content" /> 


</LinearLayout> 

在 这 个 布局 文件 中 ,首先 放置 了 3 个 按钮 ， 分 别 用 于 控制 视频 的 播放 、 和 暂停 和 
后 在 按钮 下 面 又 放置 了 一 个 VideoView， 稍 后 的 视频 就 将 在 这 里 显示 。 

接 下 来 修改 MainActivity 中 的 代码 ， 如 下 所 示 : 


public class MainActivity extends AppCompatActivity impLements View.OnClickListenert{ 


[hdl\ 


新 播放 。 然 


private VideoView videoView; 


@Override 
protected void onCreate(Bundle savedInstanceState) { 
super.onCreate(savedInstanceState), 
setContentView(R.layout.activity main); 
videoView = (VideoView) findViewById(R.id.video view); 
Button play = (Button) findViewById(R.id.play); 
Button pause = (Button) findViewById(R.id.pause); 
Button replay = (Button) findViewById(R.id.replay); 
play.setOnClickListener(this); 
pause.setOnClickListener(this); 
replay.setOnClickListener(this); 
if (ContextCompat.checkSelfPermission(MainActivity.this, Manifest. 
permission.WRITE EXTERNAL STORAGE) != PackageManager.PERMISSION GRANTED) { 
ActivityCompat.requestPermissions(MainActivity.this, new String[]{ 
Manifest.permission. WRITE EXTERNAL STORAGE }, 1); 
} else { 
initVideoPath(); // 初始 化 VideoView 
} 
} 


private void initVideoPath() { 
File file = new File(Environment.getExternalStorageDirectory(), "movie.mp4"); 
videoView.setVideoPath(file.getPath()); // 指定 视频 文件 的 路 径 

} 


@Override 
public void onRequestPermissionsResult(int requestCode, String[] permissions, 
int[] grantResults) { 
switch (requestCode) { 
Case 1: 
if (grantResults.length > 0 && grantResults[0] == PackageManager. 
PERMISSION GRANTED) { 
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initVideoPath(); 


} else { 
Toast.makeText(this，, "拒绝 权限 将 无 法 使 用 程序 ",，Toast .LENGTH_SHORT). 
show(); 
finish(); 
} 
break; 
default: 
} 
} 
GOverride 


public void onClick(View v) { 
switch (v.getId()) { 
case R.id.play: 
if (!videoView.isPlaying()) { 
videoView.start(); // 开始 播放 
} 
break ; 
case R.id.pause: 
if (videoView.isPlaying()) { 
videoView.pause(); // 暂停 播放 
} 
break ; 
case R.id.replay: 
if (videoView.isPlaying()) { 
videoView.resume(); // 重新 播放 
} 
break; 


} 


@Override 
protected void onDestroy() { 
super.onDestroy(); 
if (videoView != null) { 
videoView.suspend(); 


} 


} 


这 部 分 代码 相信 你 理解 起 来 会 很 轻松 ， 因 为 它 和 前 面 播放 音频 的 代码 非常 类 似 。 首 先 在 
onCreate() 方 法 中 同样 进行 了 一 个 运行 时 权限 处 理 , 因为 视频 文件 将 会 放 在 SD 卡 上 。 当 用 户 同 
意 授 权 了 之 后 就 会 调用 initVideoPath() 方 法 来 设置 视频 文件 的 路 径 , 这 里 我 们 需要 事先 在 SD 
卡 的 根 目录 下 放置 一 个 名 为 movie.mp4 的 视频 文件 。 

下 面 看 一 下 各 个 按钮 的 点 击 事件 中 的 代码 。 当 点 击 Play 按钮 时 会 进行 判断 ， 如 果 当 前 并 没 
有 正在 播放 视频 ， 则 调用 start () 方 法 开始 播放 。 当 点 击 Pause 按钮 时 会 判断 ， 如 果 当 前 视频 正 
在 播放 ， 则 调用 pause() 方 法 暂停 播放 。 当 点 击 Replay 按钮 时 会 判断 ， 如 果 当 前 视频 正在 播放 ， 
则 调用 resume ( ) 方 法 从 头 播放 视频 。 
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最 后 在 onDestroy ( ) 方 法 中 ， 我 们 还 需要 调用 一 下 suspend() 方 法 , 将 VideoView 所 占用 
的 资源 释放 掉 。 
另外， 仍然 始终 要 记得 在 AndroidManifest.xml 文件 中 声明 用 到 的 权限 ， 如 下 所 示 : 
<manifest xmlns:android="http://schemas.android.com/apk/res/android" 
package="com.example.playvideotest"> 
<uses-permission android:name="android.permission.WRITE EXTERNAL STORAGE" /> 
</manifest> 
现在 将 程序 运行 到 手机 上 ,会 先 弹 出 一 个 权限 申请 对 话 框 ， 同 意 授权 之 后 点 击 一 下 Play 按 
钮 ， 就 可 以 看 到 视频 已 经 开始 播放 了 ， 如 图 8.18 所 示 。 


pp Wy 
PlayVideoTest 


PLAY PAUSE REPLAY 


图 8.18 VideoView 播放 视频 的 效果 


点 击 Pause 按钮 可 以 暂停 视频 的 播放 ， 点 击 Replay 按钮 可 以 从 头 播放 视频 。 

这 样 的 话 ， 你 就 已 经 将 VideoView 的 基本 用 法 掌握 得 差不多 了 。 不 过 ， 为 什么 它 的 用 法 和 
MediaPlayer 这 么 相似 呢 ? 其 实 VideoView 只 是 帮 有 我 们 做 了 一 个 很 好 的 封装 而 已 ， 它 的 背后 仍然 
是 使 用 MediaPlayer 来 对 视频 文件 进行 控制 的 。 另 外 需要 注意 ，VideoView 并 不 是 一 个 万 能 的 视 
频 播 放 工具 类 ,， 它 在 视频 格式 的 支持 以 及 播放 效率 方面 都 存在 着 较 大 的 不 足 。 所 以 ， 如 果 想 要 仅 
仅 使 用 VideoView 就 编写 出 一 个 功能 非常 强大 的 视频 播放 器 是 不 太 现实 的 ,但 是 如 果 只 是 用 于 播 
放 一 些 游戏 的 片头 动画 ， 或 者 某 个 应 用 的 视频 宣传 ， 使 用 VideoView 还 是 绰绰有余 的 。 

好 了 , 关于 Android 多 媒体 方面 的 知识 你 已 经 学 得 足够 多 了 ,下面 就 让 我 们 一 起 来 总 结 一 下 
本 章 所 学 的 内 容 吧 。 
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8.5 小 结 与 点 评 


本 章 我 们 主要 对 Android 系统 中 的 各 种 多 媒体 技术 进行 了 学 习 ， 其 中 包括 通知 的 使 用 技巧 、 
调用 摄像 头 拍照 、 从 相册 中 选取 照片 ， 以 及 播放 音频 和 视频 文件 。 由 于 所 涉及 的 多 媒体 技术 在 模 
拟 器 上 很 难看 得 到 效果 ， 因 此 本 章 中 还 特意 讲解 了 在 Android 手机 上 调试 程序 的 方法 。 

又 是 充实 饱满 的 一 章 啊 ! 现在 多 媒体 方面 的 知识 已 经 学 得 足够 多 了 , 我 希望 你 可 以 很 好 地 将 
它们 消化 掉 , 尤其 是 与 通知 相关 的 内 容 ,因为 后 面 的 学 习 当 中 还 会 用 到 它 。 目 前 我 们 所 学 的 所 有 
东西 都 仅仅 是 在 本 地 上 进行 的 , 而 实际 上 几乎 市 场 上 的 每 个 应 用 都 会 涉及 网 络 交 互 的 部 分 , 所 以 
下 一 章 中 我 们 将 会 学 习 一 下 Android 网 络 编程 方面 的 内 容 。 
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如 果 你 在 玩 手 机 的 时 候 不 能 上 网 , 那 你 一 定 会 感到 特别 地 枯燥 乏味 。 没 错 , 现在 早已 不 是 玩 
单机 的 时 代 了 ， 无 论 是 PC、 手 机 、 平 板 ， 还 是 电视 ， 几 乎 都 会 具备 上 网 的 功能 ， 在 可 预见 的 未 
来 , 手表、 眼镜 、 汽 车 等 设备 也 会 逐个 加 入 到 这 个 行列 ，21 世纪 的 确 是 互联 网 的 时 代 。 

当然 ，Android 手机 肯定 也 是 可 以 上 网 的 ， 所 以 作为 开发 者 ， 我 们 就 需要 考虑 如 何 利 用 网 络 
来 编写 出 更 加 出 色 的 应 用 程序 ， 像 QQ 、 微 博 、 微 信 等 常见 的 应 用 都 会 大 量 使 用 网 络 技术 。 本 章 
主要 会 讲述 如 何在 手机 端 使 用 HTTP 协议 和 服务 器 端 进行 网 络 交互 , 并 对 服务 器 返回 的 数据 进行 
解析 ， 这 也 是 Android 中 最 常 使 用 到 的 网 络 技术 ， 下 面 就 让 我 们 一 起 来 学 习 一 下 吧 。 


9.1 WebView 的 用 法 


有 时 候 我 们 可 能 会 磁 到 一 些 比较 特殊 的 需求 ， 比 如 说 要 求 在 应 用 程序 里 展示 一 些 网 页 。 相 信 
每 个 人 都 知道 ， 加载 和 显示 网 页 通常 都 是 浏览 器 的 任务 , 但 是 需求 里 又 明确 指出 ,不 允许 打开 系 
统 浏览 器 ， 而 我 们 当然 也 不 可 能 自己 去 编写 一 个 浏览 器 出 来 ， 这 时 应 该 怎么 办 呢 ? 

不 用 担心 ，Android 早 就 已 经 考虑 到 了 这 种 需求 ， 并 提供 了 一 个 WebView 控件 ,借助 它 我 们 
就 可 以 在 自己 的 应 用 程序 里 让 入 一 个 浏览 器 ， 从 而 非常 轻松 地 展示 各 种 各 样 的 网 页 。 

WebView 的 用 法 也 是 相当 简单 ， 下 面 我 们 就 通过 一 个 例子 来 学 习 一 下 吧 。 新 建 一 个 
WebViewTest 项 目 ， 然 后 修改 activity_ main.xml 中 的 代码 ， 如 下 所 示 : 


<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:layout width="match parent" 
android:layout height="match parent" > 


<WebView 
android:id="@+id/web view" 
android:layout width="match parent" 
android:layout height="match parent" /> 


</LinearLayout> 
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可 以 看 到 , 我们 在 布局 文件 中 使 用 到 了 一 个 新 的 控件 : WebView。 这 个 控件 当然 也 就 是 用 来 
显示 网 页 的 了 ， 这 里 的 写法 很 简单 ， 给 它 设置 了 一 个 id， 并 让 它 充 满 整 个 屏幕 。 
然后 修改 MainActivity 中 的 代码 ， 如 下 所 示 : 


public class MainActivity extends AppCompatActivity { 


GOverride 

protected void onCreate(Bundle savedInstanceState) { 
super.onCreate(savedInstanceState); 
setContentView(R.layout.activity main); 
WebView webView = (WebView) findViewById(R.id.web view); 
webView.getSettings().setJavaScriptEnabled(true); 
webView.setWebViewClient (new WebViewClient()); 
webView.loadUrl("http://www.baidu.com"); 


} 

MainActivity 中 的 代码 也 很 得， 首先 使 用 findViewById() 方 法 获取 到 了 WebView 的 实例 ， 
然后 调用 WebView 的 getSettings() 方 法 可 以 去 设置 一 些 浏览 厦 的 属性 ， 这 里 我 们 并 不 去 设置 
过 多 的 属性 ， 只 是 调用 了 setJavaScriptEnabled() 方 法 来 让 WebView 支持 JavaScript 脚本 。 

接 下 来 是 非常 重要 的 一 个 部 分 ， 我 们 调用 了 WebView 的 setWebViewClient() 方 法 ， 并 传 
和 人 了 一 个 WebViewClient 的 实例 。 这 段 代 码 的 作用 是 ， 当 需要 从 一 个 网 页 跳 转 到 另 一 个 网 页 时 ， 
我 们 希望 目标 网 页 仍然 在 当前 WebView 中 显示 ， 而 不 是 打开 系统 浏览 器 

最 后 一 步 就 非常 简单 了 ,调用 WebView 的 LoadUrl() 方 法 ， 并 将 网 址 传人 ， 即 可 展示 相应 
网 页 的 内 容 ， 这 里 就 让 我 们 看 一 看 百度 的 首页 长 什么 样 吧 。 

另外 还 需要 注意 ,由 于 本 程序 使 用 到 了 网 络 功能 ， 而 访问 网 络 是 需要 声明 权限 的 ， 因 此 我 们 

还 得 修改 AndroidManifestxml 文件 ， 并 加 入 权限 声明 ， 如 下 所 示 : 


<manifest xmlns:android="http://schemas.android.com/apk/res/android" 
package="com.example.webviewtest"> 


<uses-permission android:name="android.permission.INTERNET" /> 


</manifest> 


在 开始 运行 之 前 ,首先 需要 保证 你 的 手机 或 模拟 器 是 联网 的 ， 如果 你 使 用 的 是 模拟 器 ， 只 需 
保证 电脑 能 正常 上 网 即 可 。 然 后 就 可 以 运行 一 下 程序 了 ， 效 果 如 图 9.1 所 示 。 
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可 以 看 到 ，WebViewTest 这 个 条 
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图 9.1 WebView 加 载 网 页 


的 首页 展示 了 出 来 ， 还 可 以 通过 点 击 链接 浏览 更 多 的 网 页 。 


当然 ，WebView 还 有 很 多 更 加 高 级 的 使 用 技巧 , 我们 就 不 再 继续 进行 探讨 了 ,因为 那 不 是 本 
章 的 重点 。 这 里 先 介绍 了 一 下 WebView 的 用 法 ， 只 是 希望 你 能 对 HTTP 协议 的 使 用 有 一 个 最 基 


本 的 认识 ， 


9.2 使 用 HTTP 协议 访问 网 络 


如 果 说 真 的 要 去 深入 分 析 HTTP 协议 , 可 能 需要 花费 整整 一 本 书 的 篇 幅 。 这 里 我 当然 不 会 这 
么 干 ， 因 为 毕竟 你 是 跟着 我 学 习 Android 开发 的 ， 而 不 是 网 站 开发 。 对 于 HTTP 协议 ， 你 只 需要 
稍微 了 解 一 些 就 足够 了 ,， 它 的 工作 原理 特别 简单 ， 就 是 客户 端 向 服务 器 发 出 一 条 HTTP 请 求 ， 服 
务 器 收 到 请 求 之 后 会 返回 一 些 数据 给 客户 端 ， 然 后 客户 端 再 对 这 些 数 据 进 行 解析 和 处 理 就 可 以 
了 。 是 不 是 非常 简单 ”一 个 浏览 器 的 基本 工作 原理 也 就 是 如 此 了 。 比 如 说 上 一 节 中 使 用 到 的 


WebView 控件 , 其 实 也 就 是 我 


时序 现在 已 经 具备 了 一 个 简易 浏览 器 的 功能 ,不仅 成 功 将 百度 


接 下 来 我 们 就 要 利用 这 个 协议 来 做 一 些 真正 的 网 络 开发 工作 了 。 


想 要 访问 的 是 百度 的 首页 ， 于 是 会 把 该 网 页 的 HTML 代码 进行 返回 ， 然 后 WebView 再 j 
浏览 器 的 内 核对 返回 的 HTML 代码 进行 解析 ， 最 终 将 页 面 展 示 出 来 。 


简单 来 说 ，WebView 已 经 在 后 台 帮 我 们 处 理 好 了 发 送 HTTP 请 求 、 接 收服 务 响 应 、 角 
数据 ,以 及 最 终 的 页 面 展示 这 儿 步 工作 , 不 过 由 于 它 封 


ME 和 4 租 分 六 


农 体 头 


在 是 太 好 了 , 反而 使 得 我 人 


门 向 百度 的 服务 器 发 起 了 一 条 HTTP 请 求 , 接着 服务 器 分 析出 我 们 


周 用 手机 


坚 析 返回 


门 不 能 那 


么 直观 地 看 出 HTTP 协议 到 底 是 如 何 工 作 的 。 因 此 , 接 下 来 就 让 我 们 通过 手动 发 送 HTTP 请 求 的 


方式 ， 来 更 加 深入 地 形 


LE 解 一 下 这 个 过 程 。 
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9.2.1 使 用 HttpURLConnection 


在 过 去 ，Android 上 发 送 HTTP 请 求 一 般 有 两 种 方式 : HttpURLConnection 和 HttpClient。 不 
过 由 于 HttpClient 存在 API 数量 过 多 、 扩 展 困难 等 缺点 ，Android 团队 越 来 越 不 建议 我 们 使 用 这 
种 方式 。 终于 在 Android 6.0 系统 中 ,HttpClient 的 功能 被 完全 移 除了 , 标志 着 此 功能 被 正式 弃 用 ， 
因此 本 小 节 我 们 就 学 习 一 下 现在 官方 建议 使 用 的 HttpURLConnection 的 用 法 。 

首先 需要 获取 到 HttpURLConnection 的 实例 ， 一 般 只 需 new 出 一 个 URL 对 象 ， 并 传人 目标 
的 网 络 地 址 ， 然 后 调用 一 下 openConnection() 方 法 即 可 ， 如 下 所 示 : 


URL url = new URL("http://www.baidu.com"); 
HttpURLConnection connection = (HttpURLConnection) url.openConnection(); 


在 得 到 了 HttpURLConnection 的 实例 之 后 ,我 们 可 以 设置 一 下 HTTP 请 求 所 使 用 的 方法 。 常 
用 的 方法 主要 有 两 个 : GET 和 P0ST。GET 表示 和 希望 从 服务 需 那 里 获取 数据 ,而 POST 则 表示 希望 
提交 数据 给 服务 器 。 写 法 如 下 : 

connection.setRequestMethod("GET"); 

接 下 来 就 可 以 进行 一 些 自由 的 定制 了 7， 比如 设置 连接 超时 、 读 取 超 时 的 上 毫秒 数 ， 以 及 服务 器 
希望 得 到 的 一 些 消 息 头 等 。 这 部 分 内 容 根 据 自己 的 实际 情况 进行 编写 ， 示例 写法 如 下 : 


connection.setConnectTimeout(8000); 
connection.setReadTimeout (8000); 


之 后 再 调用 getInputStream() 方 法 就 可 以 获取 到 服务 器 返回 的 输入 流 了 , 剩 下 的 任务 就 是 
对 输入 流 进行 读 取 ， 如 下 所 示 : 


InputStream in = connection.getInputStream(); 


最 后 可 以 调用 disconnect() 方 法 将 这 个 HTTP 连接 关闭 掉 ， 如 下 所 示 : 
connection.disconnect(); 


下 面 就 让 我 们 通过 一 个 具体 的 例子 来 真正 体验 一 下 HttpURLConnection 的 用 法 。 新 建 一 个 
NetworkTest 项目， 首先 修改 activity_main.xml 中 的 代码 ， 如 下 所 示 : 


<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:orientation="vertical" 
android:layout width="match parent" 
android:layout height="match parent" > 


<Button 
android:id="@+id/send request" 
android:layout width="match parent" 
android:layout height="wrap_ content" 
android:text="Send Request" /> 


<ScrollView 
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android:layout width="match parent" 
android:layout height="match parent" > 


<TextView 
android:id="@+id/response text" 
android:layout width="match parent" 
android:layout height="wrap content" /> 
</ScrollView> 


</LinearLayout> 

注意 这 里 我 们 使 用 了 一 个 新 的 控件 : ScrollView， 它 是 用 来 做 什么 的 呢 ?” 由 于 手机 屏幕 的 空 
间 一 般 都 比较 小 ， 有 些 时 候 过 多 的 内 容 一 屏 是 显示 不 下 的 , 借助 ScrollView 控件 的 话 ， 我们 就 可 
以 以 滚动 的 形式 查看 屏幕 外 的 那 部 分 内 容 。 男 外 ， 布 局 中 还 放置 了 一 个 Button 和 一 个 TextView， 
Button 用 于 发 送 HTTP 请 求 ，TextView 用 于 将 服务 器 返回 的 数据 显示 出 来 。 


接着 修改 MainActivity 中 的 代码 ， 如 下 所 示 : 


public class MainActivity extends AppCompatActivity implements View.0nCLickListener { 


TextView responseText 


@Override 

protected void onCreate(Bundle savedInstanceState) { 
super.onCreate(savedInstanceState);, 
setContentView(R.layout.activity main); 
Button sendRequest = (Button) findViewById(R.id.send request); 
responseText = (TextView) findViewById(R.id.response text); 
sendRequest.setOnClickListener(this); 

} 


@Override 
public void onClick(View v) { 
if (v.getId() == R.id.send request) { 
sendRequestWithHttpURLConnection(); 
} 
} 


private void sendRequestwithHttpURLConnection() { 
// 开启 线程 来 发 起 网 络 请 求 
new Thread(new Runnable() { 
@Override 
public void run() { 
HttpURLConnection connection = null; 
BufferedReader reader = null; 
try { 
URL url = new URL("https://www.baidu.com"); 
connection = (HttpURLConnection) url.openConnection(); 
connection.setRequestMethod( "GET"); 
connection.setConnectTimeout (8000); 
connection.setReadTimeout (8000); 
InputStream in = connection.getInputStream(); 
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} 


// 下 面 对 获 取 到 的 输入 流 进行 读 取 
reader = new BufferedReader(new InputstreamReader(in) ) ; 
StringBuilder response = new StringBuilder(); 
String line; 
while ((Line = reader.readLine()) != null) { 
response.append(Line) ; 
} 
showResponse(response.toString()); 
} catch (Exception e) { 
e.printStackTrace(); 
} finally { 
if (reader != null) { 
try { 
reader.closel(); 
} catch (IOException e) { 
e.printStackTrace(); 


} 
if (connection != null) { 
connection.disconnect(); 
} 
} 
} 
}).start(); 


} 


private void showResponse(final String response) { 
runOnUiThread(new Runnable() { 
@Override 
public void run() { 
// 在 这 里 进行 UI 操作 ， 将 结果 显示 到 界面 上 
responseText. setText (response); 


可 以 看 到 ， 我们 在 Send Request 按钮 的 点 击 事件 里 调用 了 sendRequestwithHttpURL- 
Connection() 方 法 ， 在 这 个 方法 中 先是 开启 了 一 个 子 线程 ， 然 后 在 子 线程 里 使 用 HttpURL- 
Connection 发 出 一 条 HTTP 请 求 ， 请 求 的 目标 地 址 就 是 百度 的 首页 。 接 着 利用 BufferedReader 对 
服务 器 返回 的 流 进行 读 取 , 并 将 结果 传人 到 了 showResponse() 方 法 中 。 而 在 showResponse() 
方法 里 则 是 调用 了 一 个 run0nUiThread () 方 法 ， 然 后 在 这 个 方法 的 匿名 类 参数 中 进行 操作 ， 将 
返回 的 数据 显示 到 界面 上 。 那 么 这 里 为 什么 要 用 这 个 run0nUiThread() 方 法 呢 ? 这 是 因为 
Android 是 不 允许 在 子 线程 中 进行 UI 操作 的 , 我 们 需要 通过 这 个 方法 将 线程 切换 到 主线 程 , 然后 
再 更 新 UI 元素。 关于 这 部 分 内 容 ， 我 们 将 会 在 下 一 章 中 进行 详细 讲解 ， 现 在 你 只 需要 记得 必须 
这 么 写 就 可 以 了 。 

完整 的 一 套 流程 就 是 这 样 ， 不 过 在 开始 运行 之 前 ， 仍 然 别 忘 了 要 声明 一 下 网 络 权 限 。 修 改 
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AndroidManifest.xml 中 的 代码 ， 如 下 所 示 : 


<manifest xmlns:android="http://schemas.android.com/apk/res/android" 
package="com.example.networktest"> 


<uses-permission android:name="android.permission.INTERNET" /> 


</manifest> 


好 了 ， 现 在 运行 一 下 程序 ， 并 点 击 Send Request 按钮 ， 结 果 如 图 9.2 所 示 。 
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NetworkTest 
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图 9.2 服务 器 响应 的 数据 


是 不 是 看 得 头晕 眼花 ? 没 错 ， 服 务 右 返回 给 我 们 的 就 是 这 种 HTML 代码 ， 只 是 通常 情况 下 
浏览 器 都 会 将 这 些 代码 解析 成 漂亮 的 网 页 后 再 展示 出 来 。 


那么 如 果 是 想 要 提交 数据 给 服务 器 应 该 怎么 办 呢 ? 其 实 也 不 复杂 , 只 需要 将 HTTP 请 求 的 方 
法 改 成 PoST， 并 在 获取 输入 流 之 前 把 要 提交 的 数据 写 出 即 可 。 注 意 每 条 数据 都 要 以 键 值 对 的 形 
式 存在 ， 数 据 与 数据 之 间 用 “&” 符 号 隔 开 ， 比 如 说 我 们 想 要 向 服务 器 提交 用 户 名 和 密码 ， 就 可 
以 这 样 写 : 

connection.setRequestMethod("POST"); 


Data0utputstream out = new DataOQutputStream(connection.getOutputStream()); 
out .writeBytes("username=adminapassword=123456" ) ; 


好 了 ， 相 信 你 已 经 将 HttpURLConnection 的 用 法 很 好 地 掌握 了 。 
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9.2.2 ”使 用 OkHttp 


当然 我 们 并 不 是 只 能 使 用 HttpURLConnection， 完 全 没有 任何 其 他 选择 ， 事 实 上 在 开源 盛行 
的 今天 , 有 许多 出 色 的 网 络 通信 库 都 可 以 替代 原生 的 HttpURLConnection, 而 其 中 OkHttp 无 疑 是 
做 得 最 出 色 的 一 个 。 

OkHttp 是 由 易 易 大 名 的 Square 公司 开发 的 ,这 个 公司 在 开源 事业 上 面 贡献 良 多 ,除了 OKkHttp 
之 外 , 还 开发 了 像 Picasso 、Retrofit 等 著名 的 开源 项 目 。OkHttp 不 仅 在 接口 封装 上 面 做 得 简单 易 
用 ， 就 连 在 底层 实现 上 也 是 自 成 一 派 ， 比 起 原生 的 HttpURLConnection， 可 以 说 是 有 过 之 而 无 不 
及 , 现在 已 经 成 了 广大 Android 开发 者 首选 的 网 络 通信 库 。 那么 本 小 节 我 们 就 来 学 习 一 下 OkHttp 
的 用 法 ，OkHttp 的 项 目 主页 地 址 是 : https:/github.com/square/okhttp 。 


在 使 用 OkHttp 之 前 , 我 们 需要 先 在 项 目 中 添加 OkHttp 库 的 依赖 。 编 辑 app/build.gradle 文件 ， 
在 dependencies 闭 包 中 添加 如 下 内 容 : 


dependencies { 
compile fileTree(dir: 'libs', include: ['*.jar']) 
compile 'com.android,.support:appcompat-v7:24.2.1" 
testCompile 'junit:junit:4.12" 
compile 'com.squareup.okhttp3:okhttp:3.4.1' 


} 

添加 上 述 依赖 会 自动 下 载 两 个 库 , 一 个 是 OkHttp 库 , 一 个 是 Okio 库 , 后 者 是 前 者 的 通信 基 
础 。 其 中 3.4.1 是 我 写本 书 时 OkHttp 的 最 新 版 本 ， 你 可 以 访问 OkHttp 的 项 目 主页 来 查看 当前 最 
新 的 版 本 是 多 少 。 

下 面 我 们 来 看 一 下 OkHttp 的 具体 用 法 ,首先 需要 创建 一 个 OkHttpClient 的 实例 ， 如 下 所 示 : 

OkHttpClient client = new OkHttpClient(); 

接 下 来 如 果 想 要 发 起 一 条 HTTP 请 求 ， 就 需要 创建 一 个 Request 对 象 : 

Request request = new Request.Builder().build(); 

当然 ， 上 述 代 码 只 是 创建 了 一 个 空 的 Request 对 象 ， 并 没有 什么 实际 作用 ， 我 们 可 以 在 最 
终 的 build() 方 法 之 前 连 级 很 多 其 他 方法 来 丰富 这 个 Request 对 象 。 比 如 可 以 通过 url() 方 法 
来 设置 日 标的 网 络 地 址 ， 如 下 所 示 : 

Request request = new Request.Builder() 


.Url("http://www.baidu.com") 
.build(); 


之 后 调用 OkHttpClient 的 newCall() 方 法 来 创建 一 个 Call 对 象 , 并 调用 它 的 execute() 方 
法 来 发 送 请 求 并 获取 服务 器 返回 的 数据 ， 写 法 如 下 : 


Response response = CLient.newCaLL(request) .execute() ; 
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其 中 Response 对 象 就 是 服务 器 返回 的 数据 了 ,我 们 可 以 使 用 如 下 写法 来 得 到 返回 的 具体 内 容 : 
String responseData = response.body().string(); 
如 果 是 发 起 一 条 P0ST 请 求 会 比 GET 请 求 稍 微 复杂 一 点 ， 我 们 需要 先 构 建 出 一 个 Request 
Body 对 象 来 存放 待 提交 的 参数 ， 如 下 所 示 : 


RequestBody requestBody = new FormBody.Builder() 


.add("username", "admin") 
.add("password", "123456") 
.build(); 


然后 在 Request.Builder 中 调用 一 下 post() 方 法 ， 并 将 RequestBody 对 象 传人 : 


Request request = new Request.Builder() 
.Url("http://www.baidu.com") 
.post(requestBody) 

.build(); 


接 下 来 的 操作 就 和 GET 请 求 一 样 了 ， 调 用 execute() 方 法 来 发 送 请 求 并 获取 服务 器 返回 的 
数据 即 可 。 

好 了 ，OkHttp 的 基本 用 法 就 先 学 到 这 里 ， 本 书 中 后 面 所 有 网 络 相关 的 功能 我 们 都 将 会 使 用 
OkHttp 来 实现 ,到 时 候 再 进行 进一步 的 学 习 。 那 么 现在 我 们 先 把 NetworkTest 这 个 项 目 改 用 OkHttp 
的 方式 再 实现 一 遍 吧 。 

由 于 布局 部 分 完全 不 用 改动 ， 所 以 现在 直接 修改 MainActivity 中 的 代码 ， 如 下 所 示 : 


public class MainActivity extends AppCompatActivity implements View.0nCLickListener { 


@Override 
public void onClick(View v) { 
if (v.getId() == R.id.send request) { 
sendRequestWithOkHttp(); 
} 
} 


private void sendRequestWithOkHttp() { 
new Thread(new Runnable() { 
@Override 
public void run() { 
try { 
OkHttpClient client = new OkHttpClient(); 
Request request = new Request.Builder() 
.Url("http://www.baidu.com") 
.build(); 
Response response = client.newCall(request) .execute() ; 
String responseData = response.body().string(); 
showResponse(responseData); 
} catch (Exception e) { 
e.printStackTrace(); 


9.3 解析 XML 格式 数据 321 


} 


} 
}).start(); 


} 


这 里 我 们 并 没有 做 太 多 的 改动 ， 只 是 添加 了 一 个 sendRequestwithOkHttp() 方 法 ， 并 在 
Send Request 按钮 的 点 击 事件 里 去 调用 这 个 方法 。 在 这 个 方法 中 同样 还 是 先 开启 了 一 个 子 线程 ， 
然后 在 子 线 程 里 使 用 OkHttp 发 出 一 条 HTTP 请 求 ， 请 求 的 目标 地 址 还 是 百度 的 首页 ，OkHttp 的 
用 法 也 正如 前 面 所 介绍 的 一 样 。 最 后 仍然 还 是 调用 了 showResponse () 方 法 来 将 服务 需 返 回 的 数 
据 显 示 到 界面 上 。 

仅仅 是 改 了 这 么 多 代码 ， 现 在 我 们 就 可 以 重新 运行 一 下 程序 了 。 点 击 Send Request 按钮 后 ， 
你 会 看 到 和 上 一 小 节 中 同样 的 运行 结果 ， 由 此 证 明 ， 使 用 OkHttp 来 发 送 HTTP 请 求 的 功能 也 已 
经 成 功 实 现 了 。 

这 样 的 话 ， 相 信 你 就 已 经 把 HttpURLConnection 和 OkHttp 的 基本 用 法 都 掌握 得 差不多 了 。 


9.3 解析 XML 格式 数据 


通常 情况 下 , 每 个 需要 访问 网 络 的 应 用 程序 都 会 有 一 个 自己 的 服务 器 , 我 们 可 以 向 服务 器 提 
交 数 据 ,， 也 可 以 从 服务 器 上 获取 数据 。 不 过 这 个 时 候 就 出 现 了 一 个 问题 , 这些 数据 到 底 要 以 什么 
样 的 格式 在 网 络 上 传输 呢 ? 随便 传递 一 段 文本 肯定 是 不 行 的 , 因为 另 一 方 根本 就 不 会 知道 这 段 文 
本 的 用 途 是 什么 。 因 此 , 一般 我 们 都 会 在 网 络 上 传输 一 些 格式 化 后 的 数据 ,这 种 数据 会 有 一 定 的 
结构 规格 和 语义 ， 当 另 一 方 收 到 数据 消息 之 后 就 可 以 按照 相同 的 结构 规格 进行 解析 ,从 而 取出 他 
想 要 的 那 部 分 内 容 。 

在 网 络 上 传输 数据 时 最 常用 的 格式 有 两 种 : XML 和 JSON , 下 面 我 们 就 来 一 个 一 个 地 进行 学 
习 ， 本 节 首 先 学 习 一 下 如 何 解析 XML 格式 的 数据 。 

在 开始 之 前 我 们 还 需要 先 解 决 一 个 问题 ， 就 是 从 哪儿 才能 获取 一 段 XML 格式 的 数据 呢 ? 这 
里 我 准备 教 你 搭建 一 个 最 简单 的 Web 服务 器 , 在 这 个 服务 器 上 提供 一 段 XML 文本 , 然后 我 们 在 
程序 里 去 访问 这 个 服务 器 ， 再 对 得 到 的 XML 文本 进行 解析 。 

搭建 Web 服务 器 其 实 非常 简单 ， 有 很 多 的 服务 器 类 型 可 供 选 择 ， 这 里 我 准备 使 用 Apache 服 
务 器 。 首 先 你 需要 去 下 载 一 个 Apache 服务 器 的 安装 包 ， 官 方 下 载 地 址 是 : http://httpd.apache.org/ 
download.cgi。 如 果 你 在 这 个 网 址 中 找 不 到 Windows 版 的 安装 包 ， 也 可 以 直接 在 百度 上 搜索 
“Apache 服务 器 下 载 ”， 将 会 找到 很 多 下 载 链接 。 

下 载 完 成 后 双击 就 可 以 进行 安装 了 ， 如 图 9.3 所 示 。 
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Welcome to the Installation Wizard for 
Apache HTIP Server 2.2.9 


The Installation Wizard will install Apache HTTP Server 2.2.9 on 
your computer, To continue, dick Next, 


WARNING: This program is protected by copyright law and 
international treaties. 


图 9.3 ”Apache 服务 器 安装 界面 


然后 一 直 点 击 Next， 会 提示 让 你 输入 自己 的 域名 ， 我们 随便 填 一 个 域名 就 可 以 了 ， 如 图 9.4 
所 示 。 


Server Information 


Please enter your server's information. 


Network Domain (e.g. somenet.com) 
test,com 


Server Name (e.g. www.somenet.com): 
Iwww. test.com 


Administrator's Email Address (e.g. webmaster @somenet.com): 
test@test.com 


Install Apache HTTP Server 2.2 programs and shortcuts for: 


© for All Users, on Port 80, as a Service — Recommended. 
© only for the Current User, on Port 8080, when started Manually. 


InstallShield 


图 9.4， 填 人 域名 和 服务 器 信息 


接着 继续 一 直 点 击 Next， 会 提示 让 你 选择 程序 安装 的 路 径 , 这 里 我 选择 安装 到 C:\Apache 目 
录 下 ， 之 后 再 继续 点 击 Next 就 可 以 完成 安装 了 。 安 装 成 功 后 服务 器 会 自动 启动 起 来 ， 你 可 以 打 
开 电 脑 的 浏览 器 来 验证 一 下 。 在 地 址 栏 输入 127.0.0.1， 如 果 出 现 了 如 图 9.5 所 示 的 界面 ， 就 说 明 
服务 器 已 经 启动 成 功 了 。 
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辑 这 


1 L27001 x 


CD127001 立国 


It works! 


图 9.5 _ Apache 服务 器 的 默认 主页 


接 下 来 进入 到 C:\Apache\htdocs 目录 下 ， 在 这 里 新 建 一 个 名 为 get data.xml 的 文件 ， 然 后 编 
个 文件 ， 并 加 入 如 下 XML 格式 的 内 容 。 


<apps> 
<app> 
<id>1</id> 
<name>Google Maps</name> 
<version>1.0</version> 
</app> 
<app> 
<id>2</id> 
<name>Chrome</name> 
<version>2.1</version> 
</app> 
<app> 
<id>3</id> 
<name>Google Play</name> 
<version>2.3</version> 
</app> 
</apps> 


这 时 在 浏览 器 中 访问 http://127.0.0.1/get_data.xml 这 个 网 址 ,就 应 该 出 现 如 图 9.6 所 示 的 内 容 。 


~ 


D 127.0.0.1/get_dataxml x We 
所 [© D 127.0.0.1/get_dataxml 空 


This XNHL file does not appear to have any style information associated with it. The 
document tree is shown below. 


《apps> 
v Capp> 
《id>1<id> 
name’Google Maps/name> 
<versior?1. 0C/version> 
/app> 
v Capp> 
《id>2<id> 
<name>Chrome<cAmname> 
《wersiorD2. 1C/version> 
fapp> 
v Capp> 
<id>301d> 
name’Google PlayC/name> 
《versiorD2. 3C/version> 
/app> 
/apps> 


图 9.6 在 浏览 器 验证 XML 数据 
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好 了 ， 准 备 工 作 到 此 结束 ， 接 下 来 就 让 我 们 在 Android 程序 里 去 获取 并 解析 这 段 XML 数 


据 吧 。 


9.3.1 Pull 解析 方式 
解析 XML 格式 的 数据 其 实 也 有 挺 多 种 方式 的 ， 本 节 中 我 们 学 习 比 较 常 用 的 两 种 ，Pull 解析 


和 SAX 解 析 。 那 么 简 征 


起 见 ， 这 里 仍然 是 在 NetworkTest 


项 目的 基 而 


上 上 继续 开发 ， 这样 我 们 就 可 


以 重用 之 前 网 络 通信 部 分 的 代码 ， 从 而 把 工作 的 重心 放 在 XML 数据 解析 上 。 
既然 XML 格式 的 数据 已 经 提供 好 了 ， 现 在 要 做 的 就 是 从 中 解析 出 我 们 想 要 得 到 的 那 部 分 内 


容 。 修 改 MainActivity 


中 的 代码 ， 如 下 所 示 : 


public class MainActivity extends AppCompatActivity implements View.0nCLickListener { 


private void 
new Thre 
@Ove 

publ 


}).start 


sendRequestwithOkHttp() { 
ad(new Runnable() { 
rride 
ic void run() { 
try { 


OkHttpClient client = new OkHttpClient(); 
Request request = new Request.Builder() 
// 指定 访问 的 服务 器 地 址 是 电脑 本 机 
.Url("http://10.0.2.2/get data.xml") 


.build(); 


Response response = client,.newCall (request).execute(); 
String responseData = response.body().string(); 
parseXMLWithPull (responseData); 


} catch (Exception e) { 
e.printStackTrace(); 


(); 


private void parseXMLWithPull(String xmlData) { 


try { 


XmLPuLLParserFactory factory = XmlPullParserFactory.newInstance(); 
ullParser xmlPullParser = factory.newPullParser(); 
xmlPullParser.setInput(new StringReader(xmLData) ) ; 


XmLP 


int 

Stri 
Stri 
Stri 


eventType = xmlPullParser.getEventType(); 
ng id 二 ne 

ng name = ""; 

ng version = ""; 


while (eventType != XmlPullParser.END DOCUMENT) { 
String nodeName = xmlPullParser.getName(); 


switch (eventType) { 
// 开始 解析 某 个 节点 
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case XmlPullParser.START_TAG: { 
if ("id".equals(nodeName)) { 
id = xmlPullParser.nextText(); 
} else if ("name".equals(nodeName)) { 
name = xmlPullParser.nextText(); 
} else if ("version".equals(nodeName)) { 
version = xmlPullParser.nextText(); 


} 
break; 
} 
// 完成 解析 某 个 节点 
case XmLPuULLParser.END_TAG: { 


if ("app".equals(nodeName)) { 


Log.d("MainActivity", "id is " 
Log.d("MainActivity", "name is " 
Log.d("MainActivity", "version is " 
} 
break; 
} 
default: 
break; 


} 


eventType = xmlPullParser.next(); 
} 
} catch (Exception e) { 


e.printStackTrace(); 
} 


} 


+ id); 
+ name); 


+ version); 


可 以 看 到 ,这 里 首先 是 将 HTTP 请 求 的 地 址 改 成 了 http://10.0.2.2/get_data.xml，10.0.2.2 对 于 
模拟 器 来 说 就 是 电脑 本 机 的 人 P 地址 。 在 得 到 了 服务 器 返回 的 数据 后 ,我 们 并 不 再 直接 将 其 展示 ， 


而 是 调用 了 parseXMLWithPulLL() 方 法 来 解析 服务 器 返回 的 数据 。 


下 面 就 来 仔细 看 下 parseXMLWithPul1() 方 法 中 的 代码 吧 。 这 里 首先 要 获取 到 一 个 
XmLPuLLParserFactory 的 实例 ， 并 借助 这 个 实例 得 到 xmLPuLLParser 对 象 ， 然 后 调用 
XmLPuLLParser 的 setInput () 方 法 将 服务 器 返回 的 XML 数据 设置 进去 就 可 以 开始 解析 了 。 解 
析 的 过 程 也 非常 简单 ， 通 过 getEventType() 可 以 得 到 当前 的 解析 事件 ， 然 后 在 一 个 while 循环 
中 不 断 地 进行 解析 ， 如 果 当 前 的 解析 事件 不 等 于 XmlPullParser.END_DOCUMENT, 说 明 解 析 工 


作 还 没完 成 ， 调 用 next ( ) 方 法 后 可 以 获取 下 一 个 解析 事件 。 


在 while 循环 中 , 我 们 通过 getName() 方 法 得 到 当前 节点 的 名 字 ， 如 里 


发 现 节点 名 等 于 id、 


name 或 version, 就 调用 nextText() 方 法 来 获取 节点 内 具体 的 内 容 , 每 当 解 析 完 一 个 app 节点 后 


就 将 获取 到 的 内 容 打 印 出 来 。 


好 了 ， 整 体 的 过 程 就 是 这 么 简单 ， 下 面 就 让 我 们 来 测试 一 下 吧 。 运 行 NetworkTest 项目， 然 


后 点 击 Send Request 按钮 ， 观 察 logcat 中 的 打印 日 志 ， 如 图 9.7 所 示 。 
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verbose 国 @- 
“es 


com. example. networktest D/MainActivity: id is 1 


com. example. networktest D/MainActivity: name is Google Maps 
com. example. networktest D/MainActivity: version is 1.0 

com. example. networktest D/MainActivity: id is 2 

com. example. networktest D/MainActivity: name is Chrome 

com. example. networktest D/MainActivity: version is 2.1 

com. example. networktest D/MainActivity: id is 3 

com. example. networktest D/MainActivity: name is Google Play 


com. example. networktest D/MainActivity: version is 2.3 


图 9.7 打印 从 XML 中 解析 出 的 数据 


可 以 看 到 ， 我 们 已 经 将 XML 数据 中 的 指定 内 容 成 功 解析 出 来 了 。 


9.3.2 SAX 解析 方式 
Pull 解析 方式 虽然 非常 好 用 ， 但 它 并 不 是 我 们 唯一 的 选择 。SAX 解析 也 是 一 种 特别 常用 的 


XML 


Ea? 


解析 方式 ， 虽然 它 的 用 法 比 Pull 解析 要 复杂 一 些 ， 但 在 语义 方面 会 更 加 清楚 。 
通常 情况 下 我 们 都 会 新 建 一 个 类 继承 自 DefaultHandler, 并 重 写 父 类 的 5 个 方法 , 如 下 所 示 : 


public class MyHandler extends DefaultHandler { 


} 


@Override 
public void startDocument() throws SAXException { 
} 


@Override 

public void startElement(String uri, String localName, String qName, Attributes 
attributes) throws SAXException { 

} 


@Override 
public void characters(char[] ch, int start, int Length) throws SAXException { 
} 


@Override 

public void endElement(String uri, String localName, String qName) throws 
SAXException { 

} 


@Override 
public void endDocument() throws SAXException { 
} 


这 5 个 方法 一 看 就 很 清楚 吧 ? startDocument() 方 法 会 在 开始 XML 解析 的 时 候 调 用 ， 
startElement() 方 法 会 在 开始 解析 某 个 节点 的 时 候 调 用 , characters() 方 法 会 在 获取 节点 中 内 
容 的 时 候 调 用 ，endELement ( ) 方 法 会 在 完成 解析 某 个 节点 的 时 候 调 用 ，endDocument ( ) 方 法 会 
在 完成 整个 XML 解析 的 时 候 调 用 。 其 中 ，startELement () 、characters() 和 endELement() 
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内 


OP 让 


窑 朋 


这 3 个 方法 是 有 参数 的 ， 从 XML 中 解析 出 的 数据 就 会 以 参数 的 形式 传人 到 这 些 方法 中 。 需 要 注 
意 的 是 ， 在 获取 节点 中 的 内 容 时 ，characters () 方 法 可 能 会 被 调用 多 次 ， 一 些 


换行 符 也 被 当 作 


坚 析 出 来 ， 我 们 需要 针对 这 种 情况 在 代码 中 做 好 控制 。 


那么 下 面 就 让 我 们 尝试 用 SAX 解析 的 方式 来 实现 和 上 一 小 节 中 同样 的 功能 吧 。 新 建 一 个 
ContentHandler 类 继承 自 DefauLtHandLer， 并 重 写 父 类 的 $ 个 方法 ， 如 下 所 示 : 


public class ContentHandler extends DefaultHandler { 


private String nodeName; 
private StringBuilder id; 
private StringBuilder name; 
private StringBuilder version; 


GOverride 

public void startDocument () throws SAXException { 
id = new StringBuilder(); 
name = new StringBuilder(); 
version = new StringBuilder(); 


} 


GOverride 

public void startELement(String uri, String localName, String qName, Attributes 
attributes) throws SAXException { 
// 记录 当前 节点 名 
nodeName = localName; 


} 


GOverride 
public void characters(char[] ch, int start, int Length) throws SAXException { 
// 根据 当前 的 节点 名 判断 将 内 容 添 加 到 哪 一 个 StringBuiLder 对 象 中 
if ("id".equals(nodeName)) { 
id.append(ch, start, length); 
} else if ("name".equals(nodeName)) { 
name.append(ch, start, length); 
} else if ("version".equals(nodeName)) { 
version.append(ch, start, length); 
3 
} 


GOverride 
public void endElement(String uri, String localName, String qName) throws 
SAXException { 
if ("app".equals(localName)) { 
Log.d("ContentHandler", "id is " + id.toString().trim()); 
Log.d("ContentHandler", "name is " + name.toString().trim()); 
Log.d("ContentHandler", "version is " + Version.toString().trim()); 
// 最 后 要 将 StringBuilder 清空 掉 
id.setLength(0); 
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name. setLength (0); 
version.setLength(0); 


} 

@Override 

public void endDocument() throws SAXException { 
super.endDocument (); 


} 
} 


可 以 看 到 ， 我 们 首先 给 id、name 和 version 节点 分 别 定义 了 一 个 StringBuilder 对 象 ， 
并 在 startDocument () 方 法 里 对 它们 进行 了 初始 化 。 每 当 开 始 解析 某 个 节点 的 时 候 ，start - 


ELement ( ) 方 法 就 会 得 到 调用 ， 其 中 LocalName 参数 记录 着 当前 节点 的 名 字 ， 这 里 我 们 把 它 记 
录 下 来 。 接 着 在 解析 节点 中 具体 内 容 的 时 候 就 会 调用 characters () 方 法 ,我 们 会 根据 当前 的 节 
点 名 进行 判断 ， 将 解析 出 的 内 容 添加 到 哪 一 个 StringBuilder 对 象 中 。 最 后 在 endElement() 
方法 中 进行 判断 ， 如 果 app 节点 已 经 解析 完成 ， 就 打印 出 id、name 和 version 的 内 容 。 需 要 注 


意 的 是 , 目前 id 、name 和 version 中 都 可 能 是 包括 回 车 或 换行 符 的 , 因此 在 打印 之 前 我 们 还 需 
要 调用 一 下 trim() 方 法 , 并 且 打 印 完成 后 还 要 将 StringBuilder 的 内 容 清空 掉 , 不 然 的 话 会 影 


响 下 一 次 内 容 的 读 取 。 


接 下 来 的 工作 就 非常 简单 了 ， 修 改 MainActivity 中 的 代码 ， 如 下 所 示 : 


public class MainActivity extends AppCompatActivity impLements View.0nCLickListener { 


private void sendRequestwithOkHttp() { 
new Thread(new Runnable() { 
@Override 
public void run() { 
try { 


OkHttpClient client = new OkHttpClient(); 
Request request = new Request.Builder() 


// 指定 访问 的 服务 器 地 址 是 电脑 本 机 


.Url("http://10.0.2.2/get data.xml") 


.build(); 


Response response = client.newCall(request).execute(); 
String responseData = response.body().string(); 


parseXMLWithSAX(responseData); 
} catch (Exception e) { 
e.printStackTrace(); 


}).start(); 
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private void parseXMLWithSAX(String xmLData) { 
try { 
SAXParserFactory factory = SAXParserFactory.newInstance() ; 
XMLReader xmLReader = factory.newSAXParser().getXMLReader(); 
ContentHandler handler = new ContentHandler(); 
// 将 ContentHandler 的 实例 设置 到 XMLReader 中 
XmLReader .setContentHandLer(handLer) ; 
// 开始 执行 解析 
xmLReader.parse(new InputSource(new StringReader (xmlData))); 
} catch (Exception e) { 
e.printStackTrace(); 
} 


} 


在 得 到 了 服务 器 返回 的 数据 后 ， 我 们 这 次 去 调用 parseXMLWithSAX() 方 法 来 解析 XML 数 
据 。parseXMLWithSAX() 方 法 中 先是 创建 了 一 个 SAXParserFactory 的 对 象 ， 然 后 再 获取 到 
XMLReader 对 象 ， 接 着 将 我 们 编写 的 ContentHandler 的 实例 设置 到 XMLReader 中 ， 最 后 调用 
parse() 方 法 开始 执行 解析 就 好 了 。 

现在 重新 运行 一 下 程序 ， 点 击 Send Request 按钮 后 观察 logcat 中 的 打印 日 志 ， 你 会 看 到 和 图 
9.7 中 一 样 的 结果 。 


除了 Pull 解析 和 SAX 解析 之 外 ， 其 实 还 有 一 种 DOM 解析 方式 也 算 挺 常用 的 ， 不 过 这 里 我 
们 就 不 再 展开 进行 讲解 了 ， 感 兴趣 的 话 你 可 以 自己 去 查阅 一 下 相关 资料 。 
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现在 你 已 经 掌握 了 XML 格式 数据 的 解析 方式 ,那么 接 下 来 我 们 要 去 学 习 一 下 如 何 解 析 JSON 
格式 的 数据 了 。 比 起 XML, JSON 的 主要 优势 在 于 它 的 体积 更 小 , 在 网 络 上 传输 的 时 候 可 以 更 省 
流量 。 但 缺点 在 于 ， 它 的 语义 性 较 差 ， 看 起 来 不 如 XML 直观 。 

在 开始 之 前 ， 我 们 还 需要 在 C:\Apache\htdocs 目录 中 新 建 一 个 get_data.json 的 文件 ， 然 后 编 
辑 这 个 文件 ， 并 加 入 如 下 JSON 格式 的 内 容 : 


[{"id":"5","version":"5.5","name":"Clash of Clans"}, 
{"id":"6","version":"7.0","name":"Boom Beach"}, 
{"id":"7","version":"3.5","name":"Clash Royale"}] 


这 时 在 浏览 器 中 访问 http://127.0.0.1/get_data.json 这 个 网 址 ,就 应 该 出 现 如 图 9.8 所 示 的 内 容 。 
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图 9.8 在 浏览 器 验证 JSON 数据 


好 了 ， 这 样 我 们 把 JSON 格式 的 数据 也 准备 好 了 ， 下 面 就 开始 学 习 如 何在 Android 程序 中 解 
析 这 些 数 据 吧 。 


9.4.1 使 用 JSONObject 


类 似 地 , 解析 JSON 数据 也 有 很 多 种 方法 ,可 以 使 用 官方 提供 的 JSONObject， 也 可 以 使 用 谷 
歌 的 开源 库 GSON。 另 外 ， 一 些 第 三 方 的 开源 库 如 Jackson、FastJSON 等 也 非常 不 错 。 本 节 中 我 
们 就 来 学 习 一 下 前 两 种 解析 方式 的 用 法 。 

修改 MainActivity 中 的 代码 ， 如 下 所 示 : 


public cLass MainActivity extends AppCompatActivity implements View.0nCLickListener { 


private void sendRequestwWithOkHttp() { 
new Thread(new Runnable() { 
@Override 
public void run() { 
try { 
OkHttpClient client = new OkHttpClient(); 
Request request = new Request.Builder() 
// 指定 访问 的 服务 器 地 址 是 电脑 本 机 
.url("http://10.0.2.2/get data.json") 
.build(); 
Response response = client.newCall(request).execute(); 
String responseData = response.body().string(); 
parseJSONWithJSONObject (responseData); 
} catch (Exception e) { 
e.printStackTrace(); 


}).start(); 
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private void parseJSONWithJSONObject(String jsonData) { 
try { 

JSONArray jsonArray = new JSONArray(jsonData) ; 

for (int i = 0; i < jsonArray.length(); i++) { 
JSONObject json0bject = jsonArray.getJSONObject(i); 
String id = jsonObject.getString("id"); 
String name = jsonObject.getString("name"); 
String version = jsonObject.getString("version"); 
Log.d("MainActivity", "id is " + id); 
Log.d("MainActivity", "name is " + name); 
Log.d("MainActivity", "version is " + version); 


} 
} catch (Exception e) { 
e.printStackTrace(); 


} 


} 


首先 记得 要 将 HTTP 请 求 的 地 址 改 成 http://10.0.2.2/get_data.json， 然 后 在 得 到 了 服务 器 返回 
的 数据 后 调用 parseJSONWithJSONObject() 方 法 来 解析 数据 。 可 以 看 到 ， 解析 JSON 的 代码 真 
的 非常 简单 ， 由 于 我 们 在 服务 器 中 定义 的 是 一 个 JSON 数组 ， 因 此 这 里 首先 是 将 服务 器 返回 的 数 
据 传 人 到 了 一 个 JSONArray 对 象 中 。 然 后 循环 遍历 这 个 JSONArray， 从 中 取出 的 每 一 个 元 素 都 
是 一 个 JSONObject 对 象 ， 每 个 JSONObject 对 象 中 又 会 包含 ijd、name 和 version 这 些 数 据 。 
接 下 来 只 需要 调用 getString () 方 法 将 这 些 数据 取出 ， 并 打印 出 来 即 可 。 


好 了 ， 就 是 这 么 简单 ! 现在 重新 运行 一 下 程序 ， 并 点 击 Send Request 按钮 ， 结 果 如 图 9.9 
所 示 。 


一 
verbose 加 Gc- ) 


com. example. networktest D/MainActivity: id is 5 


com. example. networktest D/MainActivity: name is Clash of Clans 
com. example. networktest D/MainActivity: version is 5.5 

com. example. networktest D/MainActivity: id is 6 

com. example. networktest D/MainActivity: name is Boom Beach 
com. example. networktest D/MainActivity: version is 7.0 

com. example. networktest D/MainActivity: id is 7 

com. example. networktest D/MainActivity: name is Clash Royale 


com. example. networktest D/MainActivity: version is 3.5 


图 9.9 打印 从 JSON 中 解析 出 的 数据 


9.4.2 使 用 GSON 


如 果 你 认为 使 用 JSONObject 来 解析 JSON 数据 已 经 非常 简单 了 ， 那 你 就 太 容易 满足 了 。 谷 
歌 提供 的 GSON 开源 库 可 以 让 解析 JSON 数据 的 工作 简单 到 让 你 不 敢 想象 的 地 步 , 那 我 们 肯定 是 
不 能 错过 这 个 学 习 机 会 的 。 


不 过 GSON 并 没有 被 添加 到 Android 官方 的 API 中 ,因此 如 果 想 要 使 用 这 个 功能 的 话 ， 就 必 
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须要 在 项 目 中 添加 GSON 库 的 依赖 。 编 辑 app/build.gradle 文件 , 在 dependencies 闭 包 中 添加 如 下 
内 容 : 


dependencies { 
compile fileTree(dir: 'libs', include: ['*.jar']) 
testCompile ‘junit:junit:4.12'" 
compile 'com.android,.support:appcompat-v7:24.2.1" 
compile 'com.squareup.okhttp3:okhttp:3.4.1' 
compile 'com.google.code.gson:gson:2.7' 


} 

那么 GSON 库 究竟 是 神奇 在 哪里 呢 ? 其 实 它 主要 就 是 可 以 将 一 段 JSON 格 式 的 字符 串 自 动 映 
射 成 一 个 对 象 ， 从 而 不 需要 我 们 再 手动 去 编写 代码 进行 解析 了 。 

比如 说 一 段 JSON 格式 的 数据 如 下 所 示 : 
{"name":"Tom","age":20} 
那 我 们 就 可 以 定义 一 个 Person 类 ， 并 加 入 name 和 age 这 两 个 字段 ， 然 后 只 需 简 单 地 调用 
如 下 代码 就 可 以 将 JSON 数据 自动 解析 成 一 个 Person 对 象 了 : 


Gson gson = new Gson(); 
Person person = gson.fromJson(jsonData, Person.class); 


如 果 需 要 解析 的 是 一 段 JSON 数组 会 稍微 麻烦 一 点 , 我们 需要 借助 TypeToken 将 期 望 解析 成 
的 数据 类 型 传人 到 fromJson() 方 法 中 ， 如 下 所 示 : 


List<Person> people = gson.fromJson(jsonData, new TypeToken<List<Person>>() 
{}.getType()); 


好 了 ,基本 的 用 法 就 是 这 样 ,下 面 就 让 我 们 来 真正 地 尝试 一 下 吧 。 首 先 新 增 一 个 App 类 , 并 
加 入 id、name 和 version 这 3 个 字段 ， 如 下 所 示 : 
public class App { 


private String id; 
private String name; 
private String version; 


public String getId() { 
return id; 


} 


public void setId(String id) { 
this.id = id; 

} 

public String getName() { 
return name; 


} 
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public void setName(String name) { 
this.name = name; 


} 


public String getVersion() { 
return version; 


} 


public void setVersion(String version) { 
this.version = version; 


} 
> 
然后 修改 MainActivity 中 的 代码 ， 如 下 所 示 : 


public class MainActivity extends AppCompatActivity implements View.OnClickListener { 


private void sendRequestwithOkHttp() { 
new Thread(new Runnable() { 
@Override 
public void run() { 
try { 
OkHttpClient client = new OkHttpClient(); 
Request request = new Request.Builder() 
// 指定 访问 的 服务 器 地 址 是 电脑 本 机 
.url("http://10.0.2.2/get data.json") 
.build(); 
Response response = client.newCall(request).execute(); 
String responseData = response.body().string(); 
parseJSONWithGSON(responseData); 
} catch (Exception e) { 
e.printStackTrace(); 
} 


} 
}).start(); 


private void parseJSONWithGSON(String jsonData) { 

Gson gson = new Gson(); 

List<App> appList = gson.fromJson(jsonData, new TypeToken<List<App>>() 
{}.getType()); 

for (App app : appList) { 
Log.d("MainActivity", "id is " + app.getId()); 
Log.d("MainActivity", "name is " + app.getName()); 
Log.d("MainActivity", "version is " + app.getVersion()); 
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现在 重新 运行 程序 ， 点 击 Send Request 按钮 后 观察 logcat 中 的 打印 日 志 ， 
中 一 样 的 结果 。 


你 会 看 到 和 图 9.9 


好 了 ,这样 我 们 就 算是 把 XML 和 JSON 这 两 种 数据 格式 最 常用 的 几 种 解析 方法 都 学 习 完了 ， 


在 网 络 数据 的 解析 方面 ， 你 已 经 成 功 毕业 了 。 
9.5 网 络 编程 的 最 佳 实践 


目前 你 已 经 掌握 了 HttpURLConnection 和 OkHttp 的 用 法 ， 知 道 了 如 何 发 起 HTTP 请 求 ， 以 


及 解析 服务 器 返回 的 数据 ,但 也 许 你 还 没有 发 现 ,， 之 前 我 们 的 写法 其 实 是 很 有 问题 的 。 因 为 一 个 
应 用 程序 很 可 能 会 在 许多 地 方 都 使 用 到 网 络 功 能 ， 而 发 送 HTTP 请 求 的 代码 基本 都 是 相同 的 ， 如 


果 我 们 每 次 都 去 编写 一 遍 发 送 HTTP 请 求 的 代码 ， 这 显然 是 非常 差劲 的 做 法 。 


没 错 , 通常 情况 下 我 们 都 应 该 将 这 些 通 用 的 网 络 操作 提取 到 一 个 公共 的 类 里 , 并 提供 一 个 静 
态 方 法 , 当 想 要 发 起 网 络 请 求 的 时 候 , 只 需 简 单 地 调用 一 下 这 个 方法 即 可 。 比如 使 用 如 下 的 写法 : 


public class HttpUtil { 


public static String sendHttpRequest(String address) { 

HttpURLConnection connection = null; 

try { 
URL url = new URL(address); 
connection = (HttpURLConnection) url.openConnection(); 
connection.setRequestMethod("GET"); 
connection.setConnectTimeout(8000); 
connection.setReadTimeout (8000); 
connection.setDoInput (true); 
connection.setDoOutput (true); 
InputStream in = connection.getInputStream(); 


BufferedReader reader = new BufferedReader(new InputStreamReader(in)); 


StringBuilder response = new StringBuilder(); 
String line; 
while ((line = reader.readLine()) != null) { 
response.append(line); 
} 
return response.toString(); 
} catch (Exception e) { 
e.printStackTrace(); 
return e.getMessage(); 
} finally { 
if (connection != null) { 
connection.disconnect(); 


} 


以 后 每 当 需 要 发 起 一 条 HTTP 请 求 的 时 候 就 可 以 这 样 写 : 
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String address = "http://www.baidu.com"; 
String response = HttpUtil.sendHttpRequest(address); 


在 获取 到 服务 器 响应 的 数据 后 , 我们 就 可 以 对 它 进行 解析 和 人 处理 了 。 但 是 需要 注意 ,网 络 请 
求 通常 都 是 属于 耗 时 操作 ， 而 sendHttpRequest() 方 法 的 内 部 并 没有 开启 线程 ， 这 样 就 有 可 能 
导致 在 调用 sendHttpRequest() 方 法 的 时 候 使 得 主线 程 被 阻塞 住 。 

你 可 能 会 说 ， 很 简单 嘛 ,在 sendHttpRequest() 方 法 内 部 开启 一 个 线程 不 就 解决 这 个 问题 
了 吗 ? 其实 没 有 你 想象 中 的 那么 容易 ， 因 为 如 果 我 们 在 sendHttpRequest() 方 法 中 开启 了 一 个 
线程 来 发 起 HTTP 请 求 , 那么 服务 器 响应 的 数据 是 无 法 进行 返回 的 , 所 有 的 耗 时 逻辑 都 是 在 子 线 
程 里 进行 的 ，sendHttpRequest () 方 法 会 在 服务 器 还 没 来 得 及 响应 的 时 候 就 执行 结束 了 ， 当 然 
也 就 无 法 返回 响应 的 数据 了 。 

那么 遇 到 这 种 情况 时 应 该 怎么 办 呢 ? 其 实 解决 方法 并 不 难 ， 只 需要 使 用 Java 的 回调 机 制 就 
可 以 了 ， 下 面 就 让 我 们 来 学 习 一 下 回调 机 制 到 底 是 如 何 使 用 的 。 

首先 需要 定义 一 个 接口 ， 比 如 将 它 命名 成 HttpCallbackListener， 代 码 如 下 所 示 : 

public interface HttpCallbackListener { 


void onFinish(String response); 
void onError(Exception e); 
} 
可 以 看 到 ， 我 们 在 接口 中 定义 了 两 个 方法 ，onFinish() 方 法 表示 当 服务 器 成 功 响应 我 们 请 
求 的 时 候 调 用 ，onError() 表 示 当 进行 网 络 操作 出 现 错误 的 时 候 调 用 。 这 两 个 方法 都 带 有 参数 ， 
onFinish() 方 法 中 的 参数 代表 着 服务 器 返回 的 数据 ， 而 onError() 方 法 中 的 参数 记录 着 错误 的 
详细 信息 。 
接着 修改 HttpUtil 中 的 代码 ， 如 下 所 示 : 


public class HttpUtil { 


public static void sendHttpRequest(final String address, final 
HttpCallbackListener listener) { 
new Thread(new Runnable() { 
@Override 
public void run() { 
HttpURLConnection connection = null; 
try { 
URL url = new URL(address); 
connection = (HttpURLConnection) url.openConnection(); 
connection.setRequestMethod( "GET"); 
connection.setConnectTimeout (8000); 
connection.setReadTimeout (8000); 
connection.setDoInput (true); 
connection.setDoOutput (true); 
InputStream in = connection.getInputStream(); 
BufferedReader reader = new BufferedReader (new InputStreamReader 
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(in) ) ; 


StringBuilder response = new StringBuilder(); 


String line; 


while ((line = reader.readLine()) != null) { 


response.append(line); 


} 
if (listener != null) { 
// 回调 onFinish() 方 法 


listener.onFinish(response.toString()); 


} 
} catch (Exception e) { 
if (listener != null) { 
// 回调 OnError() 方 法 
listener.onError(e); 


} 
} finally { 
if (connection != null) { 
connection.disconnect(); 
} 
} 


} 
}).start(); 


} 


我 们 首先 给 sendHttpRequest () 方 法 添加 了 一 个 HttpCallbackListener 参数 , 并 在 方法 
的 内 部 开启 了 一 个 子 线程 ， 然 后 在 子 线程 里 去 执行 具体 的 网 络 操作 。 注 意 , 子 线程 中 是 无 法 通过 
return 语句 来 返回 数据 的 ， 因 此 这 里 我 们 将 服务 器 响应 的 数据 传人 了 HttpCallbackListener 的 
onFinish () 方 法 中 ， 如 果 出 现 了 异常 就 将 异常 原因 传人 到 onError () 方 法 中 。 


现在 sendHttpRequest() 方 法 接收 两 个 参数 了 ， 因 此 我 们 在 调 月 


HttpCallbackListener 的 实例 传 入 ， 如 下 所 示 : 


HttpUtil.sendHttpRequest(address, new HttpCallbackListener() { 


@Override 

public void onFinish(String response) { 
// 在 这 里 根据 返回 内 容 执 行 具体 的 这 辑 

} 


@Override 
public void onError(Exception e) { 
// 在 这 里 对 异常 情况 进行 处 理 
} 
}); 


日 它 的 时 候 还 需要 将 


这 样 的 话 ， 当 服务 器 成 功 响应 的 时 候 ， 我 们 就 可 以 在 onFinish() 方 法 里 对 响应 数据 进行 处 
理 了 。 类 似 地 ， 如 果 出 现 了 异常 ， 就 可 以 在 onError() 方 法 里 对 异常 情况 进行 处 理 。 如 此 一 来 ， 


我 们 就 巧妙 地 利用 回调 机 制 将 响应 数据 成 功 返 回 给 调用 方 了 。 


不 过 你 会 发 现 ， 上 述 使 用 HttpURLConnection 的 写法 总 体 来 说 还 是 比较 复杂 的 ， 那 么 使 用 
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OkHttp 会 变 得 简单 吗 ? 答案 是 肯定 的 ， 而 且 要 简单 得 多 ， 下 面 我 们 来 具体 看 一 下 。 在 HttpUtil 
中 加 入 一 个 send0kHttpRequest () 方 法 ， 如 下 所 示 : 
public class HttpUtil { 


public static void sendOkHttpRequest(String address, okhttp3.Callback callback) { 
OkHttpClient client = new OkHttpClient(); 
Request request = new Request.Builder() 
.url(address) 
.build(); 
client.newCall (request) .enqueue(caLLback) ; 


} 

可 以 看 到 ，send0kHttpRequest () 方 法 中 有 一 个 okhttp3.Callback 参数 ， 这 个 是 OkHttp 
库 中 自 带 的 一 个 回调 接口 ， 类 似 于 我 们 刚才 自己 编写 的 HttpCallbackListener。 然 后 在 client. 
newCall() 之 后 没有 像 之 前 那样 一 直 调 用 execute () 方 法 , 而 是 调用 了 一 个 enqueue() 方 法 , 并 
把 okhttp3.Callback 参数 传人 。 相 信和 聪明 的 你 已 经 猜 到 了 ，OkHttp 在 enqueue() 方 法 的 内 部 
已 经 帮 有 我 们 开 好 子 线程 了 ， 然 后 会 在 子 线程 中 去 执行 HTTP 请 求 ， 并 将 最 终 的 请 求 结 果 回 调 到 
okhttp3.Callback 当中 。 

那么 我 们 在 调用 send0kHttpRequest () 方 法 的 时 候 就 可 以 这 样 写 : 


HttpUtil.sendOkHttpRequest("http://www.baidu.com", new okhttp3.Callback() { 


@Override 
public void onResponse(Call call, Response response) throws IOEXxception { 
// 得 到 服务 器 返回 的 具体 内 容 
String responseData = response.body().string(); 
} 


@Override 
public void onFailure(Call call, IOException e) { 
// 在 这 里 对 异常 情况 进行 处 理 


} 
}); 
由 此 可 以 看 出 ，OkHttp 的 接口 设计 得 确实 非常 人 性 化 ， 它 将 一 些 党 用 的 功能 进行 了 很 好 的 
封装 ， 使 得 我 们 只 需 编写 少量 的 代码 就 能 完成 较为 复杂 的 网 络 操作 。 当 然 这 并 不 是 OkHttp 的 全 


部 ， 后 面 我 们 还 会 继续 学 习 它 的 其 他 相关 知识 。 

另外 需要 注意 的 是 , 不 管 是 使 用 HttpURLConnection 还 是 OkHttp, 最 终 的 回调 接口 都 还 是 在 
子 线程 中 运行 的 ， 因 此 我 们 不 可 以 在 这 里 执行 任何 的 UI 操 作 ， 除 非 借 助 run0nUiThread ( ) 方 法 
来 进行 线程 转换 。 至 于 具体 的 原因 ， 我 们 很 快 就 会 在 下 一 章 中 学 习 到 了 。 
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9.6 小结 与 点 评 


本 章 中 我 们 主要 学 习 了 在 Android 中 使 用 HTTP 协议 来 进行 网 络 交互 的 知识 ， 虽 然 Android 
中 支持 的 网 络 通信 协议 有 很 多 种 , 但 HTTP 协议 无 疑 是 最 常用 的 一 种 。 通常 我 们 有 两 种 方式 来 发 
送 HTTP 请 求 ， 分 别 是 HttpURLConnection 和 OkHttp ， 相 信 这 两 种 方式 你 都 已 经 很 好 地 掌握 了 。 

接着 我 们 又 学 习 了 XML 和 JSON 格式 数据 的 解析 方式 ， 因 为 服务 器 响应 给 我 们 的 数据 一 般 
都 是 属于 这 两 种 格式 的 。 无 论 是 XML 还 是 JSON， 它 们 各 自 又 拥有 多 种 解析 方式 ， 这 里 我 们 只 
是 学 习 了 最 常用 的 几 种 ， 如 果 以 后 你 的 工作 中 还 需要 用 到 其 他 的 解析 方式 ， 可 以 自行 去 学 习 。 

本 章 的 最 后 同样 是 最 佳 实践 环节 ， 在 这 次 的 最 佳 实践 中 ， 我 们 主要 学 习 了 如 何 利 用 Java 的 
回调 机 制 来 将 服务 器 响应 的 数据 进行 返回 。 其 实 除 此 之 外 ， 还 有 很 多 地 方 都 可 以 使 用 到 Java 的 回 
调 机 制 ， 希望 你 能 举一反三 ， 以 后 在 其 他 地 方 需要 用 到 回调 机 制 时 都 能 够 灵活 地 使 用 。 

在 进行 了 一 章 多 媒体 和 一 章 网 络 的 相关 知识 学 习 后 ,你 是 否 想 起 来 Android 四 大 组 件 中 还 剩 
一 个 没有 学 过 呢 ! 那么 下 面 就 让 我 们 进入 到 Android 服务 的 学 习 旅 程 之 中 。 


记得 在 我 上 大 学 的 时 候 ，iPhone 是 属于 少数 人 才 拥 有 的 稀有 物品 ，Android 甚至 还 没 面 世 ， 
那个 时 候 全 球 的 手机 市 场 是 由 诺基亚 统治 着 的 。 当 时 我 觉得 诺基亚 的 Symbian 操作 系统 做 得 特 
别 出 色 ， 因 为 比 起 一 般 的 手机 ， 它 可 以 支持 后 台 功 能 。 那 个 时 候 能 够 一 边 打 着 电话 、 听 着 音乐 ， 
一 边 在 后 台 挂 着 QQ 是 件 非 常 酷 的 事情 。 所 以 我 也 曾经 单纯 地 认为 ， 支 持 后 台 的 手机 就 是 智能 
手机 。 

而 如 今 ，Symbian 早已 风光 不 再 ，Android 和 iOS 几乎 占据 了 智能 手机 全 部 的 市 场 份额 。 在 
这 两 大 移动 操作 系统 中 ，iOS 一 开始 是 不 支持 后 台 的 ， 后 来 逐渐 意识 到 这 个 功能 的 重要 性 ， 才 加 
人 了 后 台 功 能 。 而 Android 则 是 沿用 了 Symbian 的 老 习 惯 ， 从 一 开始 就 支持 后 台 功 能 ， 这 使 得 应 
用 程序 即使 在 关闭 的 情况 下 仍然 可 以 在 后 台 继 续 运行 ,不 管 怎么 说 ,后 人 台 功 能 属于 四 大 组 件 之 一 ， 
其 重要 程度 不 言 而 喻 ,那么 我 们 自然 要 好 好 学 习 一 下 它 的 用 法 了 。 


10.1 服务 是 什么 


服务 ( Service ) 是 Android 中 实现 程序 后 台 运行 的 解决 方案 ， 它 非常 适合 去 执行 那些 不 需要 
和 用 户 交 互 而 且 还 要 求 长 期 运行 的 任务 。 服 务 的 运行 不 依赖 于 任何 用 户 界 面 , 即使 程序 被 切换 到 
后 台 ， 或 者 用 户 打开 了 另外 一 个 应 用 程序 ， 服 务 仍 然 能 够 保持 正常 运行 。 

不 过 需要 注意 的 是 , 服务 并 不 是 运行 在 一 个 独立 的 进程 当中 的 , 而 是 依赖 于 创建 服务 时 所 在 
的 应 用 程序 进程 。 当 某 个 应 用 程序 进程 被 杀 掉 时 ， 所 有 依赖 于 该 进程 的 服务 也 会 停止 运行 。 


另外 , 也 不 要 被 服务 的 后 台 概念 所 迷惑 ， 实 际 上 服务 并 不 会 自动 开启 线程 ,所 有 的 代码 都 是 
默认 运行 在 主线 程 当 中 的 。 也 就 是 说 , 我 们 需要 在 服务 的 内 部 手动 创建 子 线程 ,并 在 这 里 执行 具 
体 的 任务 , 否则 就 有 可 能 出 现 主 线程 被 阻塞 住 的 情况 。 那 么 本 章 的 第 一 堂 课 , 我 们 就 先 来 学 习 一 
下 关于 Android 多 线程 编程 的 知识 。 
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10.2 Android 多 线程 编程 


熟悉 Java 的 你 ， 对 多 线程 编程 一 定 不 会 陌生 吧 。 当 我 们 需要 执行 一 些 耗 时 操作 ， 比 如 说 发 
起 一 条 网 络 请 求 时 ,考虑 到 网 速 等 其 他 原因 ， 服 务 器 未必 会 立刻 响应 我 们 的 请 求 ,如 果 不 将 这 类 
操作 放 在 子 线程 里 去 运行 , 就 会 导致 主线 程 被 阻塞 住 ， 从 而 影响 用 户 对 软件 的 正常 使 用 。 那么 就 
让 我 们 从 线程 的 基本 用 法 开始 学 习 吧 。 


10.2.1 线程 的 基本 用 法 


Android 多 线程 编程 其 实 并 不 比 Java 多 线程 编程 特殊 ， 基 本 都 是 使 用 相同 的 语法 。 比 如 说 ， 
定义 一 个 线程 只 需要 新 建 一 个 类 继承 自 Thread， 然 后 重 写 父 类 的 run() 方 法 ， 并 在 里 面 编写 耗 
时 逻辑 即 可 ， 如 下 所 示 : 


class MyThread extends Thread { 


@Override 

public void run() { 
// 处 理 具体 的 逻辑 

} 


} 

那么 该 如 何 启 动 这 个 线程 呢 ? 其 实 也 很 简单 ， 只 需要 new 出 MyThread 的 实例 ， 然 后 调用 它 
的 start () 方 法 ， 这 样 run( ) 方 法 中 的 代码 就 会 在 子 线程 当中 运行 了 ， 如 下 所 示 : 

new MyThread() .start(); 

当然 ， 使 用 继承 的 方式 耦合 性 有 点 高 ， 更 多 的 时 候 我 们 都 会 选择 使 用 实现 Runnable 接口 的 
方式 来 定义 一 个 线程 ， 如 下 所 示 : 


class MyThread implements Runnable { 


@Override 

public void run() { 
// 处 理 具体 的 逻辑 

} 


} 

如 果 使 用 了 这 种 写法 ,启动 线程 的 方法 也 需要 进行 相应 的 改变 ， 如 下 所 示 : 

MyThread myThread = new MyThread () ; 

new Thread(myThread).start(); 

可 以 看 到 , Thread 的 构造 函数 接收 一 个 Runnable 参数 , 而 我 们 new 出 的 MyThread 正 是 一 
个 实现 了 Runnable 接口 的 对 象 ， 所 以 可 以 直接 将 它 传人 到 Thread 的 构造 函数 里 。 接 着 调用 
Thread 的 start() 方 法 ，run() 方 法 中 的 代码 就 会 在 子 线程 当中 运行 了 。 
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当然 ， 如 果 你 不 想 专门 再 定义 一 个 类 去 实现 Runnabte 接口 ， 也 可 以 使 用 匿名 类 的 方式 ， 这 
种 写法 更 为 常见 ， 如 下 所 示 : 


new Thread(new Runnable() { 


@Override 

public void run() { 
// 处 理 具体 的 逻辑 

} 


}).start(); 
以 上 几 种 线程 的 使 用 方式 相信 你 都 不 会 感到 陌生 ， 因 为 在 Java 中 创建 和 启动 线程 也 是 使 用 


口 
同样 的 方式 。 了 解 了 线程 的 基本 用 法 后 , 下面 我 们 来 看 一 下 Android 多 线程 编程 与 Java 多 线程 编 
程 不 同 的 地 方 。 


10.2.2 ”在 子 线程 中 更 新 UI 


和 许多 其 他 的 GUI 库 一 样 ，Android 的 UI 也 是 线程 不 安全 的 。 也 就 是 说 ， 如 果 想 要 更 新 应 
上 程序 里 的 UI 元 素 ， 则 必须 在 主线 程 中 进行 ， 否 则 就 会 出 现 异常 。 
眼见 为 实 ， 让 我 们 通过 一 个 具体 的 例子 来 验证 一 下 吧 。 新 建 一 个 AndroidThreadTest 项 目 ， 
然后 修改 activity_main.xml 中 的 代码 ， 如 下 所 示 : 
<RelativeLayout xmlns:android="http://schemas.android.com/apk/res/android" 


android:layout width="match parent" 
android:layout height="match parent"> 


— 


<Button 
android:id="@+id/change text" 
android:layout width="match parent" 
android:layout height="wrap content" 
android:text="Change Text" /> 


<TextView 
android:id="@+id/text" 
android:layout width="wrap content" 
android:layout height="wrap content" 
android:layout centerInParent="true" 
android:text="Hello world" 
android:textSize="20sp" /> 


</RelativeLayout> 
布局 文件 中 定义 了 两 个 控件 ，TextView 用 于 在 屏幕 的 正中 央 显 示 一 个 Hello world 字符 串 ， 


Button 用 于 改变 TextView 中 显示 的 内 容 ， 我们 希望 在 点 击 Button 后 可 以 把 TextView 中 显示 的 字 
符 串 改 成 Nice to meet you。 


接 下 来 修改 MainActivity 中 的 代码 ， 如 下 所 示 : 
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public class MainActivity extends AppCompatActivity implements View.0nCLickListener { 
private TextView text; 


@Override 

protected void onCreate(Bundle savedInstanceState) { 
super.onCreate(savedInstanceState); 
setContentView(R.layout.activity main); 
text = (TextView) findViewById(R.id.text); 
Button changeText = (Button) findViewById(R.id.change text); 
changeText.setOnClickListener(this); 

} 


@Override 
public void onClick(View v) { 
switch (v.getId()) { 
case R.id.change text: 
new Thread(new Runnable() { 
@Override 
public void run() { 
text.setText("Nice to meet you"); 
} 
}).start(); 
break; 
default: 
break ; 


} 


可 以 看 到 ， 我 们 在 Change Text 按钮 的 点 击 事件 里 面 开 启 了 一 个 子 线程 ， 然 后 在 子 线程 中 调 
用 TextView 的 setText () 方 法 将 显示 的 字符 串 改 成 Nice to meet you。 代 码 的 逻辑 非常 简单 ， 只 
不 过 我 们 是 在 子 线程 中 更 新 UI 的 。 现 在 运行 一 下 程序 ， 并 点 击 Change Text 按钮 ， 你 会 发 现 程序 
果然 月 泪 了 ， 如 图 10.1 所 示 。 
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AndroidThreadTest has stopped 


Open app again 


图 10.1 在 子 线程 中 更 新 UI 导致 骨 演 


然后 观察 logcat 中 的 错误 日 志 ， 可 以 看 出 是 由 于 在 子 线程 中 更 新 UI 所 导致 的 ， 如 图 10.2 
所 示 。 


android. view. ViewRootIm1$calledrrorWrongThreadException: Only the original 
thread that created a view hierarchy can touch its views. 


图 10.2” 骨 淡 的 详细 信息 

由 此 证 实 了 Android 确实 是 不 允许 在 子 线程 中 进行 UI 操作 的 。 但 是 有 些 时 候 ， 我 们 必须 
在 子 线程 里 去 执行 一 些 耗 时 任务 ， 然 后 根据 任务 的 执行 结果 来 更 新 相应 的 UI 控件 ， 这 该 如 何 
是 好 呢 ? 

对 于 这 种 情况 ，Android 提供 了 一 套 异 步 消息 处 理 机 制 ， 完 美 地 解决 了 在 子 线程 中 进行 UI 
操作 的 问题 。 本 小 节 中 我 们 先 来 学 习 一 下 异步 消息 处 理 的 使 用 方法 ， 下 一 小 节 中 再 去 分 析 它 的 
原理 。 

修改 MainActivity 中 的 代码 ， 如 下 所 示 : 


public class MainActivity extends AppCompatActivity implements View.OnClickListener { 


public static final int UPDATE TEXT = 1; 
private TextView text; 
private Handler handler = new Handler() { 
public void handleMessage(Message msg) { 
switch (msg.what) { 


case UPDATE_TEXT: 
// 在 这 里 可 以 进行 UI 操作 


344 第 10 章 后 台 默默 的 劳动 者 -探究 服务 


text .setText("Nice to meet you"); 


break; 
default: 
break; 
} 
} 
}; 
@Override 


public void onClick(View v) { 
Switch (v.getId()) { 
case R.id.change text: 
new Thread(new Runnable() { 
@Override 
public void run() { 
Message message = new Message(); 
message.what = UPDATE TEXT; 
handler.sendMessage (message); // 将 Message 对 象 发 送出 去 


} 
}).start(); 
break; 

default: 
break; 


} 

这 里 我 们 先是 定义 了 一 个 整 型 常量 UPDATE_ TEXT， 用 于 表示 更 新 TextView 这 个 动作 。 然 后 
新 增 一 个 Handler 对 象 ， 并 重 写 父 类 的 handLeMessage () 方 法 ， 在 这 里 对 具体 的 Message 进行 
处 理 。 如 果 发 现 Message 的 what 字段 的 值 等 于 UPDATE_TEXT， 就 将 TextView 显示 的 内 容 改 成 
Nice to meet you。 

下 面 再 来 看 一 下 Change Text 按钮 的 点 击 事件 中 的 代码 。 可 以 看 到 ， 这 次 我 们 并 没有 在 子 线 
程 里 直接 进行 UI 操作 , 而 是 创建 了 一 个 Message (android.os.Message ) 对象, 并 将 它 的 what 
字段 的 值 指定 为 UPDATE_TEXT， 然 后 调用 Handler 的 sendMessage() 方 法 将 这 条 Message 发 送 
出 去 。 很 快 ，Handler 就 会 收 到 这 条 Message， 并 在 handleMessage() 方 法 中 对 它 进行 处 理 。 注 
意 此 时 handleMessage() 方 法 中 的 代码 就 是 在 主线 程 当中 运行 的 了 ， 所 以 我 们 可 以 放心 地 在 这 
里 进行 UI 操作 。 接 下 来 对 Message 携带 的 what 字段 的 值 进行 判断 ， 如 果 等 于 UPDATE _TEXT， 
就 将 TextView 显示 的 内 容 改 成 Nice to meet you。 

现在 重新 运行 程序 ， 可 以 看 到 屏幕 的 正中 央 显 示 着 Hello world。 然 后 点 击 一 下 Change Text 


按钮 ， 显 示 的 内 容 就 被 替换 成 Nice to meet you， 如 图 10.3 所 示 。 
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wi 12:40 


AndroidThreadTest 


CHANGE TEXT 


| 4 0 D | 
10.3 成功 蔡 换 显 示 的 文字 

这 样 你 就 已 经 掌握 了 Android 异步 消息 处 理 的 基本 用 法 , 使 用 这 种 机 制 就 可 以 出 色 地 解决 掉 
在 子 线程 中 更 新 UI 的 问题 。 不 过 禹 怕 你 对 它 的 工作 原理 还 不 是 很 清楚 ， 下 面 我 们 就 来 分 析 一 下 
Android 异步 消息 处 理 机 制 到 底 是 如 何 工 作 的 。 


[ 注 


10.2.3 ”解析 异步 消息 处 理 机 制 | 


Android 中 的 异步 消息 处 理 主要 由 4 个 部 分 组 成 :Message 、Handler .MessageQueue 和 Looper。 
其 中 Message 和 Handler 在 上 一 小 节 中 我 们 已 经 接触 过 了 ， 而 MessageQueue 和 Looper 对 于 你 来 
说 还 是 全 新 的 概念 ， 下 面 我 就 对 这 4 个 部 分 进行 一 下 简要 的 介绍 。 

1. Message 

Message 是 在 线程 之 间 传 递 的 消息 ， 它 可 以 在 内 部 携带 少量 的 信息 ， 用 于 在 不 同 线程 之 间 交 
换 数 据 。 上 一 小 节 中 我 们 使 用 到 了 Message 的 what 字段 , 除 此 之 外 还 可 以 使 用 argl 和 arg2 字 
段 来 携带 一 些 整 型 数据 ， 使 用 obj 字段 携带 一 个 0bject 对 象 。 

2. Handler 

Handler 顾名思义 也 就 是 处 理 者 的 意思 ， 它 主要 是 用 于 发 送 和 处 理 消息 的 。 发 送 消息 一 般 是 
使 用 Handler 的 sendMessage() 方 法 ,而 发 出 的 消息 经 过 一 系列 地 轧 转 处 理 后 ， 最 终 会 传递 到 
Handler 的 handLeMessage() 方 法 中 。 


3. MessageQueue 


MessageQueue 是 消息 队列 的 意思 , 它 主 要 用 于 存放 所 有 通过 Handler 发 送 的 消息 。 这 部 分 消 
息 会 一 直 存 在 于 消息 队列 中 ， 等 待 被 处 理 。 每 个 线程 中 只 会 有 一 个 MessageQueue 对 象 。 
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4. Looper 
Looper 是 每 个 线程 中 的 MessageQueue 的 管家 ， 调 用 Looper 的 Loop ( ) 方 法 后 ， 就 会 进入 到 
一 个 无 限 循 环 当 中 ， 然 后 每 当 发 现 MessageQueue 中 存在 一 条 消息 ， 就 会 将 它 取出 ， 并 传递 到 


Handler 的 handLeMessage() 方 法 中 。 每 个 线程 中 也 只 会 有 一 个 Looper 对 象 。 


了 解 了 Message、Handler、MessageQueue 以 及 Looper 的 基本 概念 后 ， 我 们 再 来 把 异步 消息 
处 理 的 整个 流程 梳理 一 遍 。 首 先 需要 在 主线 程 当 中 创建 一 个 Handler 对 象 ， 并 重 写 
handLeMessage () 方 法 。 然 后 当 子 线程 中 需要 进行 UI 操 作 时 ， 就 创建 一 个 Message 对 象 ， 并 通 
过 Handler 将 这 条 消息 发 送出 去 。 之 后 这 条 消息 会 被 添加 到 MessageQueue 的 队列 中 等 待 被 处 理 ， 
而 Looper 则 会 一 直 尝 试 从 MessageQueue 中 取出 待 处 理 消息 ， 最 后 分 发 回 Handler 的 
handleMessage() 方 法 中 。 由 于 Handler 是 在 主线 程 中 创建 的 ， 所 以 此 时 handleMessage() 方 
法 中 的 代码 也 会 在 主线 程 中 运行 ， 于 是 我 们 在 这 里 就 可 以 安心 地 进行 UI 操作 了 。 整 个 异步 消息 
处 理 机 制 的 流程 示意 图 如 图 10.4 所 示 。 

出 待 站 理 消息 SS 


next 


next 
Nm 9 


图 10.4 异步 消息 处 理 机 制 流程 示意 图 
一 条 Message 经 过 这 样 一 个 流程 的 轧 转 调用 后 , 也 就 从 子 线 程 进入 到 了 主线 程 ， 从 不 能 更 新 
UI 变 成 了 可 以 更 新 UI， 整 个 异步 消息 处 理 的 核心 思想 也 就 是 如 此 。 
而 我 们 在 9.2.1 小 节 中 使 用 到 的 run0nUiThread() 方 法 其 实 就 是 一 个 异步 消息 处 理 机 制 的 接 
口 封装 ， 它 虽然 表面 上 看 起 来 用 法 更 为 简单 ， 但 其 实 背 后 的 实现 原理 和 图 10.4 中 的 描述 是 一 模 
一 样 的 o 


MessageQueue 回调 dispatchMessage() 方 法 


handleMessage() 
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10.2.4 使 用 AsyncTask 


不 过 为 了 更 加 方便 我 们 在 子 线程 中 对 UI 进行 操作 ，Android 还 提供 了 另外 一 些 好 用 的 工具 ， 
比如 AsyncTask。 借 助 AsyncTask， 即 使 你 对 异步 消息 处 理 机 制 完全 不 了 解 ， 也 可 以 十 分 简单 地 
从 子 线程 切换 到 主线 程 。 当 然 ，AsyncTask 背后 的 实现 原理 也 是 基于 异步 消息 处 理 机 制 的 ， 只 是 
Android 帮 有 我 们 做 了 很 好 的 封装 而 已 。 

首先 来 看 一 下 AsyncTask 的 基本 用 法 ， 由 于 AsyncTask 是 一 个 抽象 类 ， 所 以 如 果 我 们 想 使 用 
它 ， 就 必须 要 创建 一 个 子 类 去 继承 它 。 在 继承 时 我 们 可 以 为 AsyncTask 类 指定 3 个 泛 型 参数 ， 这 
3 个 参数 的 用 途 如 下 。 

口 Params。 在 执行 AsyncTask 时 需要 传人 的 参数 ， 可 用 于 在 后 台 任 务 中 使 用 。 
口 Progress。 后 台 任 务 执行 时 ， 如 果 需 要 在 界面 上 显示 当前 的 进度 ， 则 使 用 这 里 指定 的 泛 


型 作为 进度 单位 。 
D Resutt。 当 任务 执行 完毕 后 ， 如 果 需 要 对 结果 进行 返回 ， 则 使 用 这 里 指定 的 泛 型 作为 返 
回 值 类 型 。 


因此 ， 一 个 最 简单 的 自 定义 AsyncTask 就 可 以 写成 如 下 方式 : 

class DownloadTask extends AsyncTask<Void, Integer, Boolean> { 

a 

这 里 我 们 把 AsyncTask 的 第 一 个 泛 型 参数 指定 为 Void， 表 示 在 执行 AsyncTask 的 时 候 不 需 
要 传人 参数 给 后 台 任务 。 第 二 个 泛 型 参数 指定 为 Integer, 表示 使 用 整 型 数据 来 作为 进度 显示 单 
位 。 第 三 个 泛 型 参数 指定 为 BooLean ， 则 表示 使 用 布尔 型 数据 来 反馈 执行 结 

当然 ， 目 前 我 们 自 定义 的 DownloadTask 还 是 一 个 空 任务 ， 并 不 能 进行 任何 实际 的 操作 ， 我 
们 还 需要 去 重 写 AsyncTask 中 的 几 个 方法 才能 完成 对 任务 的 定制 。 经 党 需要 去 重 写 的 方法 有 以 下 


村 个 s 


1. onPreExecute() 

这 个 方法 会 在 后 台 任 务 开始 执行 之 前 调用 , 用 于 进行 一 些 界面 上 的 初始 化 操作 ， 比 如 显示 一 
个 进度 条 对 话 框 等 。 

2. doInBackground(Params...) 

这 个 方法 中 的 所 有 代码 都 会 在 子 线程 中 运行 , 我 们 应 该 在 这 里 去 处 理 所 有 的 耗 时 任务 。 任务 
一 旦 完成 就 可 以 通过 return 语句 来 将 任务 的 执行 结果 返回 ， 如 果 AsyncTask 的 第 三 个 泛 型 参数 
指定 的 是 void， 就 可 以 不 返回 任务 执行 结果 。 注 意 , 在 这 个 方法 中 是 不 可 以 进行 UI 操作 的 ， 如 
果 需 要 更 新 UI 元 素 ， 比 如 说 反馈 当前 任务 的 执行 进度 ,可 以 调用 pubLishProgress 
(Progress...) 方 法 来 完成 。 
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3. onProgressUpdate(Progress...) 


当 在 后 台 任 务 中 调用 了 publishProgress(Progress...) 方 法 后 ，onProgressUpdate 


(Progress...) 方 法 就 会 很 快 被 调用 , 该 方法 中 携带 
个 方法 中 可 以 对 UI 进行 操作 ， 利 用 参数 中 的 数值 就 可 以 对 界面 元 素 进 行 相 应 的 更 新 。 


4. onPostExecute (Result) 


当 后 台 任 务 执行 完毕 并 通过 return 语句 进行 返回 时 ， 这 个 方法 就 很 快 会 被 调用 。 


带 的 参数 就 是 在 后 台 任 务 中 传递 过 来 的 。 在 这 


返回 的 数 


据 会 作为 参数 传递 到 此 方法 中 ， 可 以 利用 返回 的 数据 来 进行 一 些 UI 操作 ， 比 如 说 提醒 任务 执行 


的 结果 ， 以 及 关闭 掉 进 度 条 对 话 框 等 。 


因此 ， 


一 个 比较 完整 的 自 定 义 AsyncTask 就 可 以 写成 如 下 方式 : 


class DownloadTask extends AsyncTask<Void, Integer, Boolean> { 


@Override 
protected void onPreExecute() { 
progressDialog.show(); // 显示 进度 对 话 框 


} 
@Override 
protected Boolean doInBackground(Void... params) { 
try { 
while (true) { 
int downloadPercent = doDownload(); // 这 是 一 个 虚构 的 方法 
publishProgress (downloadPercent); 
if (downloadPercent >= 100) { 
break; 
} 
} catch (Exception e) { 
return false; 
; 
return true; 
} 
GOverride 


protected void onProgressUpdate(Integer... values) { 
// 在 这 里 更 新 下 载 进度 
progressDialog.setMessage("Downloaded " + values[0] + "%"); 


GOverride 

protected void onPostExecute(BooLean result) { 
progressDialog.dismiss(); // 关闭 进度 对 话 框 
// 在 这 里 提示 下 载 结果 
if (result) { 


Toast.makeText (context, "Download succeeded", Toast.LENGTH SHORT).show(); 


} else { 


Toast.makeText(context, " Download failed", Toast.LENGTH SHORT) 


} 


.Show() ; 
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} 

} 

在 这 个 DownloadTask 中 ， 我 们 在 doInBackground() 方 法 里 去 执行 具体 的 下 载 任务 。 这 个 
方法 里 的 代码 都 是 在 子 线程 中 运行 的 ， 因 而 不 会 影响 到 主线 程 的 运行 。 注 意 这 里 虚构 了 一 个 
doDowntLoad ( ) 方 法 ,这 个 方法 用 于 计算 当前 的 下 载 进度 并 返回 , 我 们 假设 这 个 方法 已 经 存在 了 。 
在 得 到 了 当前 的 下 载 进度 后 ,下 面 就 该 考虑 如 何 把 它 显 示 到 界面 上 了 , 由 于 doInBackground () 
方法 是 在 子 线 程 中 运行 的 ,在 这 里 肯定 不 能 进行 UI 操作 ,所 以 我 们 可 以 调用 publishProgress() 
方法 并 将 当前 的 下 载 进度 传 进 来 , 这 样 onProgressUpdate() 方 法 就 会 很 快 被 调用 , 在 这 里 就 可 
以 进行 UI 操 作 了 。 

当下 载 完 成 后 ，doInBackground ( ) 方 法 会 返回 一 个 布尔 型 变量 ， 这 样 onPostExecute() 
方法 就 会 很 快 被 调用 , 这 个 方法 也 是 在 主线 程 中 运行 的 。 然 后 在 这 里 我 们 会 根据 下 载 的 结果 来 弹 
出 相应 的 Toast 提示 ， 从 而 完成 整个 DownloadTask 任务 。 

简单 来 说 , 使 用 AsyncTask 的 诀窍 就 是 , 在 doInBackground() 方 法 中 执行 具体 的 耗 时 任务 ， 
在 onProgressUpdate() 方 法 中 进行 UI 操作 , 在 onPostExecute() 方 法 中 执行 一 些 任 务 的 收尾 
ES 


如 果 想 要 启动 这 个 任务 ， 只 需 编写 以 下 代码 即 可 : 

new DownLoadTask() .execute() ; 

以 上 就 是 AsyncTask 的 基本 用 法 ,怎么 样 ， 是 不 是 感觉 简单 方便 了 许多 ? 我 们 并 不 需要 去 考 
虑 什么 异步 消息 处 理 机 制 ， 也 不 需要 专门 使 用 一 个 Handler 来 发 送 和 接收 消息 ， 只 需要 调用 一 下 
publishProgress() 方 法 ， 就 可 以 轻松 地 从 子 线程 切换 到 UI 线程 了 。 

在 本 章 的 最 佳 实践 环节 ， 我 们 会 对 下 载 这 个 功能 进行 完整 的 实现 。 
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了 解 了 Android 多 线程 编程 的 技术 之 后 ， 下 面 就 让 我 们 进入 到 本 章 的 正题 ， 开 始 对 服务 的 相 
关内 容 进 行 学 习 。 作 为 Android 四 大 组 件 之 一 ， 服 务 也 少不了 有 很 多 非常 重要 的 知识 点 ， 那 我 们 
自然 要 从 最 基本 的 用 法 开始 学 习 了 。 


10.3.1 定义 一 个 服务 


首先 看 一 下 如 何在 项 目 中 定义 一 个 服务 。 新 建 一 个 ServiceTest 项 目 , 然后 右 击 com.example. 
servicetest>New 一 Service 一 Service， 会 弹出 如 图 10.5 所 示 的 窗口 。 
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出 New Android Component 和 


ure Component 


Creates a 


new service component and adds it to your Android manifest. 


Glass Name: [Myservice 


Exported 


Enabled 


[ee De Eee EE 
图 10.5 创建 服务 的 窗口 


可 以 看 到 ， 这 里 我 们 将 服务 命名 为 MyService ，Exported 属性 表示 是 否 允 许 除了 当前 程序 
之 外 的 其 他 程序 访问 这 个 服务 ，EnabtLed 属性 


性 表示 是 否 启用 这 个 服务 。 将 两 个 属性 都 勾 中 , 点击 
Finish 完成 创建 。 


现在 观察 MyService 中 的 代码 ， 如 下 所 示 : 
public class MyService extends Service { 


public MyService() { 
} 


@Override 
public IBinder onBind(Intent intent) { 

throw new UnsupportedOperationException("Not yet implemented"); 
} 


} 


可 以 看 到 ，MyService 是 继承 自 Service 类 的 ， 说 明 这 是 一 个 服务 。 目 前 MyService 中 可 
以 算是 空空 如 也 ,但 有 一 个 onBind( ) 方 法 特别 醒目 。 这 个 方法 是 Service 中 唯一 的 一 个 抽象 方法 


| 
所 以 必须 要 在 子 类 里 实现 。 我 们 会 在 后 面 的 小 节 中 使 用 到 onBind () 方 法 ， 目 前 可 以 暂时 
略 掉 。 


既然 是 定义 一 个 服务 , 自然 应 该 在 服务 中 去 处 理 一 些 事情 了 , 那 处 理事 
里 呢 ? 这 时 就 可 以 重 写 Service 中 的 另外 一 些 方法 了 ， 如 下 所 示 : 


public class MyService extends Service { 


帮 情 的 逻辑 应 该 写 在 哪 


@Override 
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public void onCreate() { 
super.onCreate(); 


} 


@Override 
public int onStartCommand(Intent intent, int flags, int startId) { 
return super.onStartCommand(intent, flags, startId); 


} 


@Override 
public void onDestroy() { 
super.onDestroy(); 


} 
} 
可 以 看 到 ， 


法 , 它们 是 每 个 服务 中 最 常用 到 的 3 个 方法 了 。 其 中 onCreate() 方 法 会 在 服务 创建 的 时 候 调 用 


onStartComma 


调用 。 


这 里 我 们 又 重 写 了 onCreate()、onStartCommand() 和 onDestroy() 这 3 个 方 


nd() 方 法 会 在 每 次 服务 启动 的 时 候 调用 ，onDestroy() 方 法 会 在 服务 销毁 的 时 候 


通常 情况 下 ， 如 果 我 们 希望 服务 一 旦 启动 就 立刻 去 执行 某 个 动作 ， 就 可 以 将 逻辑 写 在 
onStartCommand () 方 法 里 。 而 当 服务 销毁 时 ， 我 们 又 应 该 在 onDestroy() 方 法 中 去 回收 那些 不 


再 使 用 的 资源 。 


另外 需要 六 


E 意 , 每 一 个 服务 都 需要 在 AndroidManifest.xml 文件 中 进行 注册 才能 生效 , 不 知道 


你 有 没有 发 现 ,这 是 Android 四 大 组 件 共 有 的 特点 .不 过 相信 你 已 经 猜 到 了 ,智能 的 Android Studio 
早已 自动 帮 有 我 们 将 这 一 步 完 成 了 。 打 开 AndroidManifest.xml 文件 瞧 一 瞧 ， 代 码 如 下 所 示 : 


<manifest 


xmlns:android="http://schemas.android.com/apk/res/android" 


package="com.example.servicetest"> 


<application 
android:allowBackup="true" 
android:icon="@mipmap/ic launcher" 
android:label="@string/app_name" 
android:supportsRtl="true" 
android:theme="@style/AppTheme"> 


<service 


android:name=" .MyService" 
android:enabled="true" 
android:exported="true"> 


</service> 
</application> 


</manifest> 


这 样 的 话 ， 


就 已 经 将 一 个 服务 完全 定义 好 了 。 
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10.3.2 ”启动 和 停止 服务 


定义 好 了 服务 之 后 , 接 下 来 就 应 该 考虑 如 何 去 启 动 以 及 停止 这 个 服务 。 启 动 和 停止 的 方法 当 
然 你 也 不 会 陌生， 主要 是 借助 Intent 来 实现 的 ,下 面 就 让 我 们 在 ServiceTest 项 目 中 尝试 去 启动 以 
及 停止 MyService 这 个 服务 。 


首先 修改 activity_main.xml 中 的 代码 ， 如 下 所 示 : 


<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:orientation="vertical" 
android:layout width="match parent" 
android:layout height="match parent"> 


<Button 
android:id="@+id/start service" 
android:layout width="match parent" 
android:layout height="wrap_ content" 
android:text="Start Service" /> 


<Button 
android:id="@+id/stop service" 
android:layout width="match parent" 
android:layout height="wrap content" 
android:text="Stop Service" /> 


</LinearLayout> 
这 里 我 们 在 布局 文件 中 加 入 了 两 个 按钮 ， 分 别 是 用 于 启动 服务 和 停止 服务 的 。 
然后 修改 MainActivity 中 的 代码 ， 如 下 所 示 : 


public class MainActivity extends AppCompatActivity implements View.0nCLickListener { 


@Override 

protected void onCreate(Bundle savedInstanceState) { 
super.onCreate(savedInstanceState); 
setContentView(R.layout.activity main); 
Button startService = (Button) findViewById(R.id.start service); 
Button stopService = (Button) findViewById(R.id.stop service); 
startService.setOnClickListener(this); 
stopService.setOnClickListener(this); 

} 


@Override 
public void onClick(View v) { 
switch (v.getId()) { 
case R.id.start service: 
Intent StartIntent = new Intent(this, MyService.class); 
startService(startIntent); // 启动 服务 
break; 
case R.id.stop service: 
Intent stopIntent = new Intent(this, MyService.class); 
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stopService(stopIntent); // 停止 服务 
break ; 

default: 
break ; 


} 


可 以 看 到 ， 这 里 在 onCreate() 方 法 中 分 别 获取 到 了 Start Service 按钮 和 Stop Service 按钮 的 
实例 ， 并 给 它们 注册 了 点 击 事件 。 然 后 在 Start Service 按钮 的 点 击 事件 里 ， 我 们 构建 出 了 一 个 
Intent 对 象 ， 并 调用 startService() 方 法 来 启动 MyService 这 个 服务 。 在 Stop Serivce 按钮 的 
点 击 事件 里 ,我 们 同样 构建 出 了 一 个 Intent 对 象 ,并 调用 stopService() 方 法 来 停止 MyService 

这 个 服务 。startService() 和 stopService() 方 法 都 是 定义 在 Context 类 中 的 ， 所 以 我 们 在 
活动 里 可 以 直接 调用 这 两 个 方法 。 注意 , 这 里 完全 是 由 活动 来 决定 服务 何 时 停止 的 , 如 果 没 有 点 
击 Stop Service 按钮 ， 服 务 就 会 一 直 处 于 运行 状态 。 那 服务 有 没有 什么 办 法 让 自己 停止 下 来 呢 ? 
当然 可 以 ， 只 需要 在 MyService 的 任何 一 个 位 置 调用 stopSelf() 方 法 就 能 让 这 个 服务 停止 下 
来 了 。 

那么 接 下 来 又 有 一 个 问题 需要 思考 了 , 我 们 如 何 才能 证 实 服务 已 经 成 功 启 动 或 者 停止 了 呢 ? 
最 简单 的 方法 就 是 在 MyService 的 几 个 方法 中 加 入 打印 日 志 ， 如 下 所 示 


public class MyService extends Service { 


GOverride 
public void onCreate() { 

super.onCreate(); 

Log.d("MyService", "onCreate executed"); 
} 


GOverride 

public int onStartCommand(Intent intent, int flags, int startId) { 
Log.d("MyService", "onStartCommand executed"); 
return super.onStartCommand(intent, flags, startId); 

} 


GOverride 
public void onDestroy() { 


super.onDestroy(); 
Log.d("MyService", "onDestroy executed"); 


} 
现在 可 以 运行 一 下 程序 来 进行 测试 了 ， 程 序 的 主 界面 如 图 10.6 所 示 。 
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3 站 232 
ServiceTest 


START SERVICE 


STOP SERVICE 


4 O 〇 口 


图 10.6 ”ServiceTest 的 主 界面 


点 击 一 下 Start Service 按钮 ， 观 察 logcat 中 的 打印 日 志 ， 如 图 10.7 所 示 。 


[verose 加 G- 


com. example. servicetest D/MyService: onCreate executed 


com. example. servicetest D/MyService: onStartCommand executed 


图 10.7 启动 服务 时 的 打印 日 志 


MyService 中 的 onCreate() 和 onStartCommand() 方 法 都 执行 了 ， 说 明 这 个 服务 确实 已 经 启 
动 成 功 了 ， 并 且 你 还 可 以 在 Settings 一 Developer options 一 人 Running services 中 找到 它 ， 如 图 10.8 
所 示 。 


3 2:43 


Running serv.. Show CACHED PROCESSES 


App RAM usage 


他 Settings 33 MB 
1 process and 0 services 


ServiceTest 11 MB 
1 process and 1 service )6:4 


Google Play services 35 MB 


Dh 1 process and 5 services 


Google Play services 27 MB 
sand 1 service 


od 1 proce 


Android Keyboard (AOSP) 83 MB 
1 process and 1 service 5 


图 10.8 ”正在 运行 的 服务 列表 
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然后 再 点 击 一 下 Stop Service 按钮 ， 观 察 logcat 中 的 打印 日 志 ， 如 网 10.9 所 示 。 
verbose 加 G- ) 


图 10.9 停止 服务 时 的 打印 日 志 

由 此 证 明 ，MyService 确实 已 经 成 功 停 目下 来 了 。 

话说 回来 , 虽然 我 们 已 经 学 会 了 启动 服务 以 及 停止 服务 的 方法 , 不 知道 你 心里 现在 有 没有 一 
个 疑惑 ， 那 就 是 onCreate() 方 法 和 onStartCommand () 方 法 到 底 有 什么 区 别 呢 ? 因为 刚刚 点 击 
Start Service 按钮 后 两 个 方法 都 执行 了 。 


其 实 onCreate( ) 方 法 是 在 服务 第 一 次 创建 的 时 候 调 用 的 ， 而 onStartCommand ( ) 方 法 则 在 
每 次 启动 服务 的 时 候 都 会 调用 ， 由 于 刚才 我 们 是 第 一 次 点 击 Start Service 按钮 ， 服 务 此 时 还 未 创 
建 过 ， 所 以 两 个 方法 都 会 执行 ， 之 后 如 果 你 再 连续 多 点 击 几 次 Start Service 按钮 ， 你 就 会 发 现 只 
有 onStartCommand () 方 法 可 以 得 到 执行 了 。 
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上 一 小 节 中 我 们 学 习 了 启动 和 停止 服务 的 方法 , 不 知道 你 有 没有 发 现 , 虽然 服务 是 在 活动 里 
启动 的 , 但 在 启动 了 服务 之 后 , 活动 与 服务 基本 就 没有 什么 关系 了 。 确实 如 此 ,我 们 在 活动 里 调 
用 了 startService() 方 法 来 启动 MyService 这 个 服务 ,然后 MyService 的 onCreate() 和 
onStartCommand ( ) 方 法 就 会 得 到 执行 。 之 后 服务 会 一 直 处 于 运行 状态 ， 但 具体 运行 的 是 什么 逻 
辑 , 活动 就 控制 不 了 了 。 这 就 类 似 于 活动 通知 了 服务 一 下 :“ 你 可 以 启动 了 !” 然 后 服务 就 去 忙 自 
己 的 事情 了 ， 但 活动 并 不 知道 服务 到 底 去 做 了 什么 事情 ， 以 及 完成 得 如 何 。 

那么 有 没有 什么 办 法 能 让 活动 和 服务 的 关系 更 紧密 一 些 呢 ? 例如 在 活动 中 指挥 服务 去 干 什 
么 ， 服务 就 去 干什么 。 当 然 可 以 ， 这 就 需要 借助 我 们 刚刚 忽略 的 onBind() 方 法 了 。 


比如 说 ,目前 我 们 希望 在 MyService 里 提供 一 个 下 载 功能 ,然后 在 活动 中 可 以 决定 何 时 开始 
下 载 ， 以 及 随时 查看 下 载 进 度 。 实 现 这 个 功能 的 思路 是 创建 一 个 专门 的 Binder 对 象 来 对 下 载 功 
能 进行 管理 ， 修 改 MyService 中 的 代码 ， 如 下 所 示 : 


public class MyService extends Service { 


private DownloadBinder mBinder = new DownloadBinder(); 
class DownloadBinder extends Binder { 
public void startDownload() { 


Log.d("MyService", "startDownload executed"); 


public int getProgress() { 
Log.d("MyService", "getProgress executed"); 
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return 0; 


} 


@Override 
public IBinder onBind(Intent intent) { 
return mBinder; 


} 


} 

可 以 看 到 ， 这 里 我 们 新 建 了 一 个 DowntLoadBinder 类 ， 并 让 它 继承 自 Binder， 然 后 在 它 的 
内 部 提供 了 开始 下 载 以 及 查看 下 载 进 度 的 方法 。 当 然 这 只 是 两 个 模拟 方法 , 并 没有 实现 真正 的 功 
能 ， 我 们 在 这 两 个 方法 中 分 别 打 印 了 一 行 日 志 。 

接着 ,在 MyService 中 创建 了 DownloadBinder 的 实例 ， 然 后 在 onBind ( ) 方 法 里 返回 了 这 个 
实例 ， 这 样 MyService 中 的 工作 就 全 部 完成 了 。 

下 面 就 要 看 一 看 , 在 活动 中 如 何 去 调 用 服务 里 的 这 些 方法 了 。 首先 需要 在 布局 文件 里 新 增 两 
个 按钮 ， 修 改 activity_main.xml 中 的 代码 ， 如 下 所 示 : 


<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:orientation="vertical" 
android:layout width="match parent" 
android:layout height="match parent"> 


<Button 
android:id="@+id/bind_ service" 
android:Tlayout width="match_parent" 
android:layout height="wrap_content" 
android: text="Bind Service" /> 


<Button 
android:id="@+id/unbind_ service" 
android:Tlayout width="match_parent" 
android:layout height="wrap_content" 
android: text="Unbind Service" /> 


</LinearLayout> 

这 两 个 按钮 分 别 是 用 于 绑 定 服务 和 取消 绑 定 服务 的 , 那 到 底 谁 需要 去 和 服务 绑 定 呢 ? 当然 就 
是 活动 了 。 当 一 个 活动 和 服务 绑 定 了 之 后 ， 就 可 以 调用 该 服务 里 的 Binder 提供 的 方法 了 。 修 改 
MainActivity 中 的 代码 ， 如 下 所 示 : 


public class MainActivity extends AppCompatActivity implements View.0nCLickListener { 


private MyService.DownloadBinder downloadBinder; 
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} 


private ServiceConnection connection = new ServiceConnection() { 


}; 


@Override 
public void onServiceDisconnected(ComponentName name) { 


} 


@Override 

public void onServiceConnected(ComponentName name, IBinder service) { 
downloadBinder = (MyService.DownloadBinder) service; 
downloadBinder .startDownload(); 
downloadBinder .getProgress(); 


GOverride 
protected void onCreate(Bundle savedInstanceState) { 


} 


super.onCreate(savedInstanceState); 
setContentView(R.layout.activity main); 


Button bindService = (Button) findViewById(R.id.bind service); 
Button unbindService = (Button) findViewById(R.id.unbind service); 
bindService.setOnClickListener(this); 
unbindService.setOnClickListener(this); 


GOverride 
public void onClick(View v) { 


switch (v.getId()) { 


case R.id.bind_ service: 
Intent bindIntent = new Intent(this, MyService.class); 
bindService(bindIntent，connection，BIND_AUTO_CREATE) ; // 绑 定 服务 
break; 

case R.id.unbind_ service: 
unbindService(connection); // 解 绑 服务 
break; 

default: 
break; 


这 里 我 们 首先 创建 了 一 个 ServiceConnection 的 匿名 类 ， 在 里 面 重 写 了 onService- 
Connected () 方 法 和 onServiceDisconnected () 方 法 ， 这 两 个 方法 分 别 会 在 活动 与 服务 成 功 绑 
定 以 及 活动 与 服务 的 连接 断 开 的 时 候 调 用 。 在 onServiceConnected() 方 法 中 , 我 们 又 通过 向 下 
转型 得 到 了 DownloadBinder 的 实例 ,有 了 这 个 实例 ,活动 和 服务 之 间 的 关系 就 变 得 非常 基 密 了 。 
现在 我 们 可 以 在 活动 中 根据 具体 的 场景 来 调用 DownLoadBinder 中 的 任何 public 方法 , 即 实现 
了 指挥 服务 干什么 服务 就 去 干什么 的 功能 。 这 里 仍然 只 是 做 了 个 简单 的 测试 ， 在 onService- 
Connected ( ) 方 法 中 调用 了 DownloadBinder 的 startDownLoad() 和 getProgress () 方 法 。 
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当然 ， 现 在 活动 和 服务 其 实 还 没 进行 绑 定 呢 ， 这 个 功能 是 在 Bind Service 按钮 的 点 击 事件 里 
完成 的 。 可 以 看 到 , 这 里 我 们 仍然 是 构建 出 了 一 个 Intent 对 象 , 然后 调用 bindService( ) 方 法 
将 MainActivity 和 MyService 进行 绑 定 。bindService() 方 法 接收 3 个 参数 ， 第 一 个 参数 就 是 刚 
刚 构建 出 的 Intent 对 象 ， 第 二 个 参数 是 前 面 创 建 出 的 ServiceConnection 的 实例 ， 第 三 个 参数 则 
是 一 个 标志 位 ， 这 里 传人 BIND_AUT0_CREATE 表示 在 活动 和 服务 进行 绑 定 后 自动 创建 服务 。 这 
会 使 得 MyService 中 的 onCreate() 方 法 得 到 执行 ,但 onStartCommand () 方 法 不 会 执行 。 

然后 如 果 我 们 想 解 除 活 动 和 服务 之 间 的 绑 定 该 怎么 办 呢 ? 调用 一 下 unbindService() 方 法 
就 可 以 了 ， 这 也 是 Unbind Service 按钮 的 点 击 事件 里 实现 的 功能 。 


现在 让 我 们 重新 运行 一 下 程序 吧 ， 界 面 如 图 10.10 所 示 。 


Wi BB 2:55 


ServiceTest 


START SERVICE 


STOP SERVICE 


BIND SERVICE 


UNBIND SERVICE 


本 Oo 口 


图 10.10 ServiceTest 新 的 主 界面 


点 击 一 下 Bind Service 按钮 ， 然 后 观察 logcat 中 的 打印 日 志 ， 如 图 10.11 所 示 。 


图 10.11 绑 定 服务 时 的 打印 日 志 
可 以 看 到 ， 首 先是 MyService 的 onCreate( ) 方 法 得 到 了 执行 ， 然 后 startDownload() 和 
getProgress() 方 法 都 得 到 了 执行 , 说 明 我 们 确实 已 经 在 活动 里 成 功 调用 了 服务 里 提供 的 方法 了 。 
另外 需要 注意 ,任何 一 个 服务 在 整个 应 用 程序 范围 内 都 是 通用 的 ， 即 MyService 不 仅 可 以 和 
MainActivity 绑 定 ， 还 可 以 和 任何 一 个 其 他 的 活动 进行 绑 定 ， 而 且 在 绑 定 完成 后 它们 都 可 以 获取 
到 相同 的 DownloadBinder 实例 。 
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10.4 服务 的 生命 周期 


之 前 我 们 学 习 过 了 活动 以 及 碎片 的 生命 周期 。 类 似 地 ， 服 务 也 有 自己 的 生命 周期 ， 前 面 我 们 
使 用 到 的 onCreate() 、onStartCommand() 、onBind() 和 onDestroy() 等 方法 都 是 在 服务 的 生 
命 周期 内 可 能 回调 的 方法 。 

一 旦 在 项 目的 任何 位 置 调用 了 Context 的 startService() 方 法 , 相应 的 服务 就 会 启动 起 来 ， 
并 回调 onStartCommand () 方 法 。 如 果 这 个 服务 之 前 还 没有 创建 过 ，onCreate () 方 法 会 先 于 
onStartCommand () 方 法 执行 。 服 务 启动 了 之 后 会 一 直 保持 运行 状态 ， 直 到 stopService() 或 
stopSelf() 方 法 被 调用 。 注意, 虽然 每 调用 一 次 startService() 方 法 ,onStartCommand() 就 
会 执行 一 次 , 但 实际 上 每 个 服务 都 只 会 存在 一 个 实例 。 所 以 不 管 你 调用 了 多 少 次 startService() 
方法 ， 只 需 调 用 一 次 stopService() 或 stopSelf() 方 法 ， 服务 就 会 停止 下 来 了 。 

另外 , 还 可 以 调用 Context 的 bindService() 来 获取 一 个 服务 的 持久 连接 ,这 时 就 会 回调 服 
务 中 的 onBind() 方 法 。 类 似 地 ， 如 果 这 个 服务 之 前 还 没有 创建 过 ，onCcreate () 方 法 会 先 于 
onBind () 方 法 执行 。 之 后 ， 调 用 方 可 以 获取 到 onBind ( ) 方 法 里 返回 的 IBinder 对 象 的 实例 ， 
这 样 就 能 自由 地 和 服务 进行 通信 了 。 只 要 调用 方 和 服务 之 间 的 连接 没有 断 开 , 服务 就 会 一 直 保 持 
运行 状态 。 

当 调 用 了 startService() 方 法 后 ， 又 去 调用 stopService() 方 法 ， 这 时 服务 中 的 
onDestroy() 方 法 就 会 执行 ， 表示 服务 已 经 销毁 了 。 类 似 地 ， 当 调用 了 bindService() 方 法 后 ， 
又 去 调用 unbindService() 方 法 ，onDestroy() 方 法 也 会 执行 ， 这 两 种 情况 都 很 好 理解 。 但 是 
需要 注意 ， 我 们 是 完全 有 可 能 对 一 个 服务 既 调 用 了 startService() 方 法 ， 又 调用 了 
bindService() 方 法 的 , 这 种 情况 下 该 如 何 才能 让 服务 销毁 掉 呢 ? 根据 Android 系统 的 机 制 ， 一 
个 服务 只 要 被 启动 或 者 被 绑 定 了 之 后 , 就 会 一 直 处 于 运行 状态 , 必须 要 让 以 上 两 种 条 件 同时 不 满 
足 ,， 服务 才能 被 销毁 。 所 以 , 这 种 情况 下 要 同时 调用 stopService() 和 unbindService( ) 方 法 ， 
onDestroy () 方 法 才 会 执行 。 


这 样 你 就 已 经 把 服务 的 生命 周期 完整 地 走 了 一 遍 。 


10.5 服务 的 更 多 技巧 

以 上 所 学 的 都 是 关于 服务 最 基本 的 一 些 用 法 和 概念 ， 当 然 也 是 最 常用 的 。 不 过 ,仅仅 满足 于 
此 显然 是 不 够 的 ， 关 于 服务 的 更 多 高 级 使 用 技巧 还 在 等 着 我 们 呢 ， 下 面 就 赶快 去 看 一 看 吧 。 
10.5.1 使 用 前 台 服 务 


服务 几乎 都 是 在 后 台 运行 的 , 一 直 以 来 它 都 是 默默 地 做 着 辛苦 的 工作 。 但 是 服务 的 系统 优先 
级 还 是 比较 低 的 ， 当 系统 出 现 内存 不 足 的 情况 时 ， 就 有 可 能 会 回收 掉 正在 后 台 运 行 的 服务 。 如 果 
你 希望 服务 可 以 一 直 保持 运行 状态 ， 而 不 会 由 于 系统 内 存 不 足 的 原因 导致 被 回收 ,就 可 以 考虑 使 
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用 前 台 服 务 。 


前 合 服务 和 普通 服务 最 大 的 区 别 就 在 于 ， 0 一 直 有 一 个 正在 运行 的 图 标 在 系统 的 


栏 显示 ， 下 拉 状 态 栏 后 可 以 看 到 更 加 详细 的 信息 ， 类 似 于 通知 的 效果 。 当 然 有 时 候 你 也 


能 不 仅仅 是 为 了 防止 服务 被 回收 掉 才 使 用 前 A 和 些 项 目 由 于 特殊 的 需求 会 要 求 必须 使 


前 台 服 务 ， 比 如 说 彩云 天 气 这 款 天 气 预 报应 用 , 它 的 服务 在 后 台 更 新 天 气 数 据 的 同时 ,还 会 在 


系统 状态 栏 一 直 显 示 当 前 的 天 气 信息 ， 如 图 10.12 所 示 。 


21:51 
[区 =] 


六 、19* 阴 
一 未 来 两 小 时 不 会 下 雨 ， 放 心 出 门 吧 


图 10.12 ”彩云 天 气 的 前 台 服 务 效果 


那么 我 们 就 来 看 一 下 如 何 才 能 创建 一 个 前 台 服 务 吧 ， 其 实 并 不 复杂 ,修改 MyService 中 的 代 
码 ， 如 下 所 示 : 


public class MyService extends Service { 


@Override 
public void onCreate() { 


super.onCreate(); 

Log.d("MyService", "onCreate executed"); 

Intent intent = new Intent(this, MainActivity.class); 

PendingIntent pi = PendingIntent.getActivity(this, 0, intent, 0); 

Notification notification = new NotificationCompat.Builder(this) 
.SetContentTitle("This is content title") 
.SetContentText("This is content text") 
.Setwhen(System.currentTimeMillis()) 
.SetSmaLLIcon(R.mipmap.ic_Launcher) 
.SetLargeIcon(BitmapFactory.decodeResource(getResources ()， 

R.mipmap.ic launcher)) 

.SetContentIntent (pi) 
.build(); 

startForeground(1, notification); 
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: 


可 以 看 到 ， 这 里 只 是 修改 了 onCreate() 方 法 中 的 代码 ， 相 信 这 部 分 代码 你 会 非常 眼熟 。 没 
错 ! 这 就 是 我 们 在 第 8 章 中 学 习 的 创建 通知 的 方法 。 只 不 过 这 次 在 构建 出 Notification 对 象 后 
并 没有 使 用 NotificationManager 来 将 通知 显示 出 来 ， 而 是 调用 了 startForeground() 方 法 。 这 
个 方法 接收 两 个 参数 ， 第 一 个 参数 是 通知 的 id， 类 似 于 notify() 方 法 的 第 一 个 参数 ， 第 二 个 参 
数 则 是 构建 出 的 Notification 对 象 。 调 用 startForeground () 方 法 后 就 会 让 MyService 变 成 
一 个 前 台 服 务 ， 并 在 系统 状态 栏 显 示 出 来 。 

现在 重新 运行 一 下 程序 ， 并 点 击 Start Service 或 Bind Service 按钮 ，MyService 就 会 以 前 台 服 
务 的 模式 启动 了 , 并 且 在 系统 状态 栏 会 显示 一 个 通知 图 标 , 下 拉 状 态 栏 后 可 以 看 到 该 通知 的 详细 
内 容 ， 如 图 10.13 所 示 。 


图 10.13 ”前 台 服 务 的 状态 栏 效果 
前 台 服 务 的 用 法 就 这 么 简单 ， 只 要 你 在 第 8 章 中 将 通知 的 用 法 掌握 好 了 , 学 习 本 节 的 知识 一 

定 会 特别 轻松 。 

10.5.2 ”使 用 IntentService 


话说 回来 , 在 本 章 一 开始 的 时 候 我 们 就 已 经 知道 , 服务 中 的 代码 都 是 默认 运行 在 主线 程 当 中 
的 , 如 果 直 接 在 服务 里 去 处 理 一 些 耗 时 的 逻辑 ,就 很 容易 出 现 ANR ( Application NotResponding ) 
的 情况 。 
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所 以 这 个 时 候 就 需要 用 到 Android 多 线程 编程 的 技术 了 , 我 们 应 该 在 服务 的 每 个 具体 的 方法 
里 开启 一 个 子 线程 ， 然 后 在 这 里 去 处 理 那些 耗 时 的 逻辑 。 因此， 一 个 比较 标准 的 服务 就 可 以 写成 
如 下 形式 : 


public class MyService extends Service { 


@Override 
public int onStartCommand(Intent intent, int flags, int startId) { 
new Thread(new Runnable() { 
@Override 
public void run() { 
// 处 理 具体 的 有 逻辑 


} 
}).start(); 
return super.onStartCommand(intent, flags, startId); 


} 


但 是 ， 这 种 服务 一 旦 启动 之 后 ， 就 会 一 直人 处 于 运行 状态 ， 必 须 调用 stopService() 或 者 
stopSelf() 方 法 才能 让 服务 停止 下 来 。 所 以 ， 如 果 想 要 实现 让 一 个 服务 在 执行 完毕 后 自动 停止 
的 功能 ， 就 可 以 这 样 写 : 


public class MyService extends Service { 


@Override 
public int onStartCommand(Intent intent, int flags, int startId) { 
new Thread(new Runnable() { 
@Override 
public void run() { 
// 处 理 具 体 的 逻辑 
stopSelf(); 
} 
}).start(); 
return super.onStartCommand(intent, flags, startId); 


} 


虽说 这 种 写法 并 不 复杂 ， 但 是 总 会 有 一 些 程序 员 忘 记 开 启 线程 ， 或 者 忘记 调用 stopSelf() 
方法 。 为 了 可 以 简单 地 创建 一 个 异步 的 、 会 自动 停止 的 服务 ，Android 专门 提供 了 一 
IntentService 类 ， 这 个 类 就 很 好 地 解决 了 前 面 所 提 到 的 两 种 尴 做 ， 下 面 我 们 就 来 看 一 下 它 的 
用 法 。 

新 建 一 个 MyIntentService 类 继承 自 IntentService， 代码 如 下 所 示 : 
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public class MyIntentService extends IntentService { 


public MyIntentService() { 
super("MyIntentService"); // 调用 父 类 的 有 参 构造 函数 
} 


@Override 
protected void onHandleIntent(Intent intent) { 

// 打印 当前 线程 的 id 

Log.d("MyIntentService", "Thread id is " + Thread.currentThread(). getId()); 
} 


@Override 
public void onDestroy() { 
super.onDestroy(); 
Log.d("MyIntentService", "onDestroy executed"); 


J} 


这 里 首先 要 提供 一 个 无 参 的 构造 函数 , 并 且 必 须 在 其 内 部 调用 父 类 的 有 参 构造 函数 。 然 后 要 
在 子 类 中 去 实现 onHandleIntent() 这 个 抽象 方法 ， 在 这 个 方法 中 可 以 去 处 理 一 些 具 体 的 逻辑 ， 
而 且 不 用 担心 ANR 的 问题 ， 因 为 这 个 方法 已 经 是 在 子 线程 中 运行 的 了 。 这 里 为 了 证 实 一 下 ,我 
们 在 onHandleIntent() 方 法 中 打印 了 当前 线程 的 id。 男 外 根据 IntentService 的 特性 ， 这 个 
服务 在 运行 结束 后 应 该 是 会 自动 停止 的 ， 所 以 我 们 又 重 写 了 onDestroy() 方 法 ， 在 这 里 也 打印 
了 一 行 日 志 ， 以 证 实 服务 是 不 是 停止 掉 了 。 

接 下 来 修改 activity_main.xml 中 的 代码 ,加 入 一 个 用 于 启动 MyIntentService 这 个 服务 的 按钮， 
如 下 所 示 : 


<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:orientation="vertical" 
android:layout width="match parent" 
android:layout height="match parent"> 


<Button 
android:id="@+id/start_intent_ service" 
android:Tlayout width="match_parent" 
android:layout height="wrap_content" 
android:text="Start IntentService" /> 


</LinearLayout> 
然后 修改 MainActivity 中 的 代码 ， 如 下 所 示 : 


public class MainActivity extends AppCompatActivity implements View.OnClickListener { 
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@Override 

protected void onCreate(Bundle savedInstanceState) { 
super.onCreate(savedInstanceState);, 
setContentView(R.layout.activity main); 


Button startIntentService = (Button) findViewById(R.id.start intent_ 
service); 
startIintentService.setOnClickListener(this); 
} 


@Override 
public void onClick(View v) { 
Switch (v.getId()) { 


case R.id.start intent_service: 
// 打印 主线 程 的 id 
Log.d("MainActivity", "Thread id is " + Thread.currentThread(). 
getId()); 
Intent intentService = new Intent(this, MyIntentService.class); 
startService(intentService); 
break; 
default: 
break; 


} 


可 以 看 到 ， 我 们 在 Start IntentService 按钮 的 点 击 事件 里 面 去 启动 MyIntentService 这 个 服务 ， 
并 在 这 里 打印 了 一 下 主线 程 的 id, 稍 后 用 于 和 JIntentService 进行 比 对 。 你 会 发 现 ,其 实 IntentService 
的 用 法 和 普通 的 服务 没什么 两 样 。 

最 后 不 要 忘记 ， 服 务 都 是 需要 在 AndroidManifest.xml 里 注册 的 ， 如 下 所 示 : 


<manifest xmlns:android="http://schemas.android.com/apk/res/android" 
package="com.exampLe,servicetest"> 


<application 
android:allowBackup="true" 
android:icon="@mipmap/ic launcher" 
android:label="@string/app_name" 
android:supportsRtl="true" 
android:theme="@style/AppTheme"> 


<service android:name=" .MyIntentService" /> 
</application> 


</manifest> 
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当然 你 也 可 以 使 用 Android Studio 提供 的 快捷 方式 来 创建 IntentService， 不 过 由 于 这 样 会 自 
动 生 成 一 些 我 们 用 不 到 的 代码 ， 因 此 这 里 我 采用 了 手动 创建 的 方式 。 


现在 重新 运行 一 下 程序 ， 界 面 如 图 10.14 所 示 。 


Wi B 1:58 
ServiceTest 


START SERVICE 
STOP SERVICE 
BIND SERVICE 

UNBIND SERVICE 


START INTENTSERVICE 


图 10.14 ServiceTest 更 新 后 的 主 界面 
点 击 Start IntentService 按钮 后 ， 观 察 logcat 中 的 打印 日 志 ， 如 图 10.15 所 示 。 


a \ 
Verbose -| IQr 有 


/com. example. servicetest D/MainActivity: Thread id is 1 
com. example. servicetest D/MyIntentService: Thread id is 154 


com. example. servicetest D/MyIntentService: onDestroy executed 


图 10.15 ”启动 IntentService 时 的 打印 日 志 


可 以 看 到 ， 不 仅 MyIntentService 和 MainActivity 所 在 的 线程 id 不 一 样 ， 而 且 onDestroy () 
方法 也 得 到 了 执行 ， 说 明 MyIntentService 在 运行 完毕 后 确实 自动 停止 了 。 集 开启 线程 和 自动 停 
止 于 一 身 ，IntentService 还 是 博得 了 不 少 程序 员 的 喜爱 。 

好 了 ， 关 于 服务 的 知识 点 你 已 经 学 得 够 多 了 ， 下 面 就 让 我 们 进入 到 本 章 的 最 佳 实践 环节 吧 。 
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本 章 中 你 已 经 掌握 了 很 多 关于 服务 的 使 用 技巧 ， 但 是 当 在 真正 的 项 目 里 需要 用 到 服务 的 时 
候 ， 可 能 还 会 有 一 些 棘 手 的 问题 让 你 不 知 所 措 。 因 此 ， 下 面 我 们 就 来 综合 运用 一 下 ,尝试 实 现 
个 在 服务 中 经 常会 使 用 到 的 功能 一 一 下 载 。 
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本 节 中 我 们 将 要 编写 一 个 完整 版 的 下 载 示 例 ， 其 中 会 涉及 第 7 章 、 第 8 章 、 第 9 章 和 第 10 
章 的 部 分 内 容 ， 算 是 目前 为 止 综合 程度 最 高 的 一 个 例子 了 。 准 备 好 了 吗 ? 创建 一 个 
ServiceBestPractice 项 目 ， 然 后 开始 本 节 的 学 习 之 旅 吧 。 


首先 我 们 需要 将 项 目 中 会 使 用 到 的 依赖 库 添加 好 ,编辑 app/build.gradle 文件 ,在 dependencies 
闭 包 中 添加 如 下 内 容 : 


dependencies { 
compile fileTree(dir: 'libs', include: ['*.jar']) 
compile 'com.android,support:appcompat-v7:24.2.1" 
testCompile 'junit:junit:4.12'" 
compile 'com.squareup.okhttp3:okhttp:3.4.1' 


} 

这 里 只 需 添加 一 个 OkHttp 的 依赖 就 行 了 ， 待 会 儿 在 编写 网 络 相 关 的 功能 时 ， 我 们 将 使 用 
OkHttp 来 进行 实现 。 

接 下 来 需要 定义 一 个 回调 接口 ， 用 于 对 下 载 过 程 中 的 各 种 状态 进行 监听 和 回调 。 新 建 一 个 
DownloadListener 接口 ， 代 码 如 下 所 示 : 


public interface DownloadListener { 
void onProgress(int progress); 
void onSuccess(); 
void onFailed(); 
void onPaused () ; 
void onCanceted() ; 
} 
可 以 看 到 ， 这 里 我 们 一 共 定 义 了 5 个 回调 方法 ，onProgress() 方 法 用 于 通知 当前 的 下 载 进 


度 ，onSuccess() 方 法 用 于 通知 下 载 成 功 事 件 ，onFailed() 方 法 用 于 通知 下 载 失 败 事件 ， 
onPaused() 方 法 用 于 通知 下 载 暂停 事件 ，onCanceled() 方 法 用 于 通知 下 载 取 消 事 件 。 


回调 接口 定义 好 了 之 后 , 下 面 我 们 就 可 以 开始 编写 下 载 功 能 了 。 这 里 我 准备 使 用 本 章 中 刚 学 
的 AsyncTask 来 进行 实现 ， 新 建 一 个 DownLoadTask 继承 自 AsyncTask， 代 码 如 下 所 示 : 


public class DownloadTask extends AsyncTask<String, Integer, Integer> { 


public static final int TYPE SUCCESS = 0; 
public static final int TYPE FAILED ; 
public static final int TYPE PAUSED 


= 1 
-2 
public static final int TYPE CANCELED = 


3; 


private DownloadListener listener; 
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private boolean isCanceled = false; 
private boolean isPaused = false; 
private int lastProgress; 


public DownloadTask(DownloadListener Listener) { 
this.listener = listener; 


} 


GOverride 
protected Integer doInBackground(String... params) { 
InputStream is = null; 
RandomAccessFile savedFile = null; 
File file = null; 
try { 
Long downloadedLength = 0; // 记录 已 下 载 的 文件 长 度 
String downloadUrl = params[0]; 
String fileName = downloadUrl.substring(downloadUrl.lastIndex0f("/")); 
String directory = Environment.getExternalStoragePublicDirectory 
(Environment .DIRECTORY DOWNLOADS) .getPath(); 
file = new File(directory + fileName); 
if (file.exists()) { 
downloadedLength = fite.Length() ; 
} 
Long contentLength = getContentLength(downloadUrl); 
if (contentLength == 0) { 
return TYPE_ FAILED; 
} else if (contentLength == downloadedLength) { 
// 已 下 载 字 节 和 文件 总 字 节 相等 ， 说 明 已 经 下 载 完 成 了 
return TYPE SUCCESS,; 
} 
OkHttpClient client = new OkHttpClient(); 
Request request = new Request.Builder!() 
// 断 点 下 载 ， 指 定 从 哪个 字 节 开始 下 载 
.addHeader ("RANGE", "bytes=" + downloadedLength + "-") 
.Url (downloadUrl) 
.build(); 
Response response = client,.newCall (request).execute(); 
if (response != null) { 
is = response.body().byteStream(); 
savedFile = new RandomAccessFile(file, "rw"); 
savedFile.seek(downloadedLength); // 跳 过 已 下 载 的 字 节 
byte[] b = new byte[1024]; 
int total = 0; 
int len; 
while ((len = is.read(b)) != -1) { 
if (isCanceled) { 
return TYPE CANCELED; 
} else if(isPaused) { 
return TYPE_ PAUSED; 
} else { 
total += len; 
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savedFile.write(b, 0, len); 
// 计算 已 下 载 的 百分比 
int progress = (int) ((total + downloadedLength) * 100 / 
ContentLength ) ; 
pubLishProgress(progress ) ; 
} 
} 
response.body().closel(); 
return TYPE SUCCESS,; 
} 
} catch (Exception e) { 
e.printStackTrace(); 


} finally { 
try { 
if (is != null) { 
is.close(); 
} 


if (savedFile != null) { 
savedFile.close(); 

} 

if (isCanceled && file != null) { 
file.delete(); 

} 

} catch (Exception e) { 
e.printStackTrace(); 


} 
} 
return TYPE FAILED; 
} 
@Override 


protected void onProgressUpdate(Integer... values) { 
int progress = values[0]; 
if (progress > lastProgress) { 
listener.onProgress(progress); 
lastProgress = progress; 


} 


@Override 
protected void onPostExecute(Integer status) { 
switch (status) { 
case TYPE SUCCESS: 
listener.onSuccess(); 
break; 
case TYPE FAILED: 
listener.onFailed!(); 
break; 
case TYPE_PAUSED : 
Listener.onPaused () ; 
break ; 
case TYPE CANCELED: 
Listener.onCanceLed ( ) ; 
break ; 
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default: 
break; 


} 


public void pauseDownload() { 
isPaused = true; 


} 


public void cancelDownload() { 
isCanceled = true; 


} 


private Long getContentLength(String downloadUrl) throws IOException { 
OkHttpClient client = new OkHttpClient(); 
Request request = new Request.Builder() 
.Url (downloadUrl) 
.build(); 
Response response = client.newCall(request).execute(); 
if (response != null && response.isSuccessful()) { 
long contentLength = response.body().contentLength(); 
response.body().close(); 
return contentLength; 


return 0; 


J} 


0 比较 长 了 ,我 们 需要 一 步 步 地 进行 分 析 。 首 先 看 一 下 AsyncTask 中 的 3 个 泛 型 参 
数 : 2 String， 表 示 在 执行 AsyncTask 的 时 候 需 要 传人 一 个 字符 串 参 数 给 
De 二 个 泛 型 参数 指定 为 Integer, 表示 使 用 整 型 数据 来 作为 进度 显示 单位 ; 第 三 个 泛 
型 参数 指定 Integer， 则 表示 使 用 整 型 数据 来 反馈 执行 结果 。 


接 下 来 我 们 定义 了 4 个 整 型 常量 用 于 表示 下 载 的 状态 ，TYPE SUCCESS 表示 下 载 成 功 ， 
TYPE_FAILED 表示 下 载 失 败 ，TYPE_PAUSED 表示 暂停 下 载 ，TYPE_CANCELED 表示 取消 下 载 。 然 
后 在 DownLoadTask 的 构造 函数 中 要 求 传人 一 个 刚刚 定义 的 DownloadListener 参数 ， 我 们 待 
会 就 会 将 下 载 的 状态 通过 这 个 参数 进行 回调 。 

接着 就 是 要 重 写 doInBackground() .onProgressUpdate() 和 onPostExecute() 这 3 个 方 
法 了 , 我 们 之 前 已 经 学 习 过 这 3 个 方法 各 自 的 作用 , 因此 在 这 里 它们 各 自 所 负责 的 任务 也 是 明确 
的 : doInBackground () 方 法 用 于 在 后 台 执行 具体 的 下 载 逻辑 ，onProgressUpdate( ) 方 法 用 于 
在 界面 上 更 新 当前 的 下 载 进度 ，onPostExecute( ) 用 于 通知 最 终 的 下 载 结果 。 


那么 先 来 看 一 下 doInBackground () 方 法 ， 首 先 我 们 从 参数 中 获取 到 了 下 载 的 URL 地 址 ， 
并 根据 URL 地 址 解析 出 了 下 载 的 文件 名 ， 然 后 指定 将 文件 下 载 到 Environment.DIRECTORY 
DOWNLOADS 目录 下 ， 也 就 是 SD 卡 的 Download 目录 。 我 们 还 要 判断 一 下 Download 目录 中 是 
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不 是 已 经 存在 要 下 载 的 文件 了 , 如 果 已 经 存在 的 话 则 读 取 已 下 载 的 字 节 数 , 这 样 就 可 以 在 后 面 启 
用 断 点 续 传 的 功能 。 接 下 来 先是 调用 了 getContentLength ( ) 方 法 来 获取 待 下 载 文件 的 总 长 度 ， 
如 果 文 件 长 度 等 于 0 则 说 明文 件 有 问题 , 直接 返回 TYPE_FAILED, 如 果 文 件 长 度 等 于 已 下 载 文件 
长 度 ， 那 么 就 说 明文 件 已 经 下 载 完 了 ， 直 接 返回 TYPE_SUCCESS 即 可 。 紧 接着 使 用 OkHttp 来 发 
送 一 条 网 络 请 求 ， 需 要 注意 的 是 ,这 里 在 请 求 中 添加 了 一 个 header， 用 于 告诉 服务 器 我 们 想 要 从 
哪个 字 节 开始 下 载 , 因为 已 下 载 过 的 部 分 就 不 需要 再 重新 下 载 了 。 接 下 来 读 取 服 务 器 响应 的 数据 ， 
并 使 用 Java 的 文件 流 方式 ， 不 断 从 网 络 上 读 取 数据 ， 不 断 写 入 到 本 地 ， 一 直到 文件 全 部 下 载 完 
成 为 止 。 在 这 个 过 程 中 , 我 们 还 要 判断 用 户 有 没有 触发 暂停 或 者 取消 的 操作 ， 如果 有 的 话 则 返回 
TYPE_PAUSED 或 TYPE_CANCELED 来 中 断 下 载 ， 如 果 没 有 的 话 则 实时 计算 当前 的 下 载 进度 ， 然 后 
调用 pubLishProgress () 方 法 进行 通知 。 和 暂停 和 取消 操作 都 是 使 用 一 个 布尔 型 的 变量 来 进行 控 
制 的 ， 调 用 pauseDowntLoad() 或 canceLDowntLoad () 方 法 即 可 更 改变 量 的 值 。 

接 下 来 看 一 下 onProgressUpdate() 方 法 , 这 个 方法 就 简单 得 多 了 , 它 首先 从 参数 中 获取 到 
当前 的 下 载 进度 ， 然 后 和 上 一 次 的 下 载 进 度 进行 对 比 ， 如 果 有 变化 的 话 则 调用 DownloadListener 
的 onProgress() 方 法 来 通知 下 载 进度 更 新 。 

最 后 是 onPostExecute() 方 法 , 也 非常 简单 ， 就 是 根据 参数 中 传人 的 下 载 状 态 来 进行 回调 。 
下 载 成 功 就 调用 DownloadListener 的 onSuccess() 方 法 , 下载 失败 就 调用 onFailed() 方 法 , 暂 
停 下 载 就 调用 onPaused() 方 法 ， 取 消 下 载 就 调用 onCanceled() 方 法 。 

这 样 我 们 就 把 具体 的 下 载 功能 完成 了 ， 下 面 为 了 保证 DownloadTask 可 以 一 直 在 后 台 运行 ， 
我 们 还 需要 创建 一 个 下 载 的 服务 。 右 击 com.example.servicebestpractice 一 New 一 Service 一 Service， 
新 建 DownloadService， 然 后 修改 其 中 的 代码 ， 如 下 所 示 : 


public class DownloadService extends Service { 


/ 


private DownloadTask downloadTask; 
private String downloadUrl; 


private DownloadListener listener = new DownloadListener() { 
GOverride 
public void onProgress(int progress) { 
getNotificationManager().notify(1, getNotification("Downloading...", 
progress)); 
} 


GOverride 
public void onSuccess() { 
downloadTask = null; 
// 下 载 成 功 时 将 前 台 服务 通知 关闭 ， 并 创建 一 个 下 载 成 功 的 通知 
stopForeground(true); 
getNotificationManager().notify(1, getNotification("Download Success", 
-1)); 
Toast.makeText (DownloadService.this, "Download Success", 
Toast .LENGTH SHORT).show(); 
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} 


@Override 

public void onFailed() { 
downloadTask = null; 
// 下 载 失败 时 将 前 人 台 服 务 通知 关闭 ， 并 创建 一 个 下 载 失败 的 通知 
stopForeground(true); 


getNotificationManager().notify(1, getNotification("Download Failed", 


-1)); 
Toast.makeText (DownloadService.this, "Download Failed", 
Toast .LENGTH SHORT).show(); 


} 


@Override 
public void onPaused() { 
downloadTask = null; 


Toast.makeText (DownloadService.this, "Paused", Toast.LENGTH SHORT). 


Show( ) ; 


@Override 

public void onCanceled() { 
downloadTask = null; 
stopForeground(true); 


Toast.makeText (DownloadService.this, "Canceled", Toast.LENGTH SHORT). 


Show( ) ; 


并 
private DownloadBinder mBinder = new DownloadBinder(); 


GOverride 
public IBinder onBind(Intent intent) { 
return mBinder; 


} 


class DownloadBinder extends Binder { 


public void startDownload(String url) { 
if (downloadTask == null) { 
downloadUrl = url; 
downloadTask = new DownloadTask(listener); 
downloadTask.execute (downloadUrl); 
startForeground(1, getNotification("Downloading...", 0)); 
Toast.makeText (DownloadService.this, "Downloading...", Toast. 
LENGTH SHORT) .show() ; 


} 


public void pauseDownload() { 
if (downloadTask != null) { 
downloadTask.pauseDownload(); 


} 
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} 


public void cancelDownload() { 
if (downloadTask != null) { 
downloadTask.cancelDownload(); 
} else { 
if (downloadUrl != nuLL) { 
// 取消 下 载 时 需 将 文件 删除 ， 并 将 通知 关闭 
String fileName = downloadUrl.substring(downloadUrl. 
lastIndex0f("/")); 
String directory = Environment.getExternalStoragePublicDirectory 
(Environment .DIRECTORY DOWNLOADS) .getPath(); 
File file = new File(directory + fileName); 
if (file.exists()) { 
file.delete(); 
} 
getNotificationManager().cancel(1); 
stopForeground (true); 
Toast.makeText (DownloadService.this, "Canceled", 
Toast .LENGTH SHORT).show(); 


} 


private NotificationManager getNotificationManager() { 
return (NotificationManager) getSystemService(NOTIFICATION SERVICE); 
} 


private Notification getNotification(String title, int progress) { 

Intent intent = new Intent(this, MainActivity.class); 

PendingIntent pi = PendingIntent.getActivity(this, 0, intent, 0); 

NotificationCompat.Builder builder = new NotificationCompat.Builder(this); 

builder.setSmallIcon(R.mipmap.ic launcher); 

builder.setLargeIlcon(BitmapFactory.decodeResource(getResources(), 
R.mipmap.ic launcher)); 

builder.setContentIntent (pi); 

builder.setContentTitle(title); 

if (progress > = 0) { 
// 当 progress 大 于 或 等 于 0 时 才 需 显示 下 载 进度 
builder.setContentText(progress + "%"); 
builder.setProgress(100, progress, false); 

} 

return builder.build(); 


} 


这 段 代 码 同 样 也 比较 长 , 我 们 还 是 得 耐心 慢 慢 看 。 首 先 这 里 创建 了 一 个 DownloadListener 
的 匿名 类 实例 , 并 在 匿名 类 中 实现 了 onProgress()、onSuccess()、onFailed()、onPaused() 
和 onCanceled() 这 5 个 方法 。 在 onProgress ( ) 方 法 中 , 我 们 调用 getNotification() 方 法 构 
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建 了 一 个 用 


F 显示 下 载 进 度 的 通知 ， 然 后 调用 NotificationManager 的 notify() 方 法 去 触发 这 个 


通知 ， 这 样 就 可 以 在 下 拉 状 态 栏 中 实时 看 到 当前 下 载 的 进度 了 。 在 onSuccess () 方 法 中 ,我 们 


首先 是 将 正在 下 载 的 


下 上 了、 这 


用 全 如 


个 方法 也 都 是 类 似 的 ， 分 别 用 于 告诉 用 户 下 载 失 败 、 

接 下 来 为 了 要 让 DownloadService 可 以 和 活动 进行 通信 ,我 们 又 创建 了 一 个 DownloadBinder。 
DownloadBinder 中 提供 了 startDownload()、paus 
方法 , 那么 顾名思义 , 它们 分 别 是 用 于 开始 下 载 、 暂 停 下 载 和 取消 下 载 的 。 在 startDownload() 


方法 中 ， 我 们 创建 了 一 个 DownloadTask 的 实例 ， 把 
后 调用 execute() 方 法 开启 下 载 ， 并 将 下 载 文件 的 URL 地 址 传人 到 execute() 方 法 中 。 同 时 ， 


知 关 闭 , 然后 了 创建 一 个 新 的 通知 用 于 告诉 用 户 下 载 成 功 了 。 其 他 几 


暂停 和 取消 这 几 个 事件 。 


eDownload() 和 cancelDownload() 这 3 个 


刚才 的 DownloadListener 作为 参数 传人 ， 然 


为 了 让 这 个 下 载 服 务 成 为 一 个 前 台 服 务 ， 我 们 还 调用 了 startForeground() 方 法 ， 这 样 就 会 在 
系统 状态 栏 中 创建 一 个 持续 运行 的 通知 了 。 接着 往 下 看 , pauseDowntLoad () 方 法 中 的 代码 就 非常 


简单 了 ,就 是 简单 地 调用 了 一 下 DownloadTask 中 的 pauseDownload() 方 法 ,cancelDownload() 
方法 中 的 逻辑 也 基本 类 似 , 但 是 要 注意 ,取消 下 载 的 时 候 我 们 需要 将 正在 下 载 的 文件 删除 掉 ， 这 
一 点 和 和 暂停 下 载 是 不 同 的 。 

另外 , DownloadService 类 中 所 有 使 用 到 的 通知 都 是 调用 getNotification() 方 法 进行 构 
建 的 ， 这 个 方法 中 的 代码 我 们 之 前 基本 都 是 学 过 的 ， 只 有 一 个 setProgress () 方 法 没有 见 过 。 
setProgress() 方 法 接收 3 个 参数 , 第 一 个 参数 传人 通知 的 最 大 进度 , 第 二 个 参数 传人 通知 的 当 
前 进度 ， 第 三 个 参数 表示 是 否 使 用 模糊 进度 条 ， 这 里 传人 false。 设置 完 setProg ress () 方 法 ， 
通知 上 就 会 有 进度 条 显示 出 来 了 。 

现在 下 载 的 服务 也 已 经 成 功 实现 , 后 端的 工作 基本 都 完成 了 , 那么 接 下 来 我 们 开始 编写 前 端 
的 部 分 。 修 改 activity_main.xml 中 的 代码 ， 如 下 所 示 : 

<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 

android:orientation="vertical" 


android:layout width="match parent" 
android:layout height="match parent"> 


<Button 


android: 
android: 
android: 
android: 


<Button 


android: 
android: 
android: 
android: 


<Button 


android: 
android: 


id="@+id/start download" 
layout width="match parent" 


layout height="wrap content" 


text="Start Download" /> 


id="@+id/pause download" 
layout width="match parent" 


layout height="wrap content" 


text="Pause Download" /> 


id="@+id/cancel download" 
layout width="match parent" 
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android:layout height="wrap content" 
android:text="Cancel Download" /> 


</LinearLayout> 


布局 文件 还 是 非常 简单 的 ， 这 里 在 LinearLayout 中 放置 了 3 个 按钮 ,分别 用 于 开始 下 载 、 暂 
停 下 载 和 取消 下 载 。 
然后 修改 MainActivity 中 的 代码 ， 如 下 所 示 : 


public cLass MainActivity extends AppCompatActivity impLements View.0nCLickListener { 


private DownloadService.DownloadBinder downLoadBinder; 
private ServiceConnection connection = new ServiceConnection() { 


GOverride 
public void onServiceDisconnected(ComponentName name) { 


} 


GOverride 
public void onServiceConnected(ComponentName name, IBinder service) { 
downloadBinder = (DownloadService.DownloadBinder) service; 


} 
}; 


@Override 
protected void onCreate(Bundle savedInstanceState) { 
super.onCreate(savedInstanceState); 
setContentView(R.layout.activity main); 
Button startDownload = (Button) findViewById(R.id,start download); 
Button pauseDownload = (Button) findViewById(R.id.pause download); 
Button cancelDownload = (Button) findViewById(R.id.cancel download); 
startDownload.setOnClickListener(this); 
pauseDownload.setOnClickListener(this); 
cancelDownload.setOnClickListener(this); 
Intent intent = new Intent(this, DownloadService.class); 
startService(intent); // 启动 服务 
bindService(intent,，connection，BIND AUTO_CREATE); // 绑 定 服务 
if (ContextCompat.checkSelfPermission(MainActivity.this, Manifest. 
permission.WRITE EXTERNAL STORAGE)!= PackageManager.PERMISSION GRANTED) { 
ActivityCompat.requestPermissions (MainActivity.this, new 
String[]{ Manifest.permission. WRITE EXTERNAL STORAGE }, 1); 


} 


@Override 
public void onClick(View v) { 
if (downloadBinder == null) { 
return; 
} 
Switch (v.getId()) { 
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} 


case R.id.start download: 
String url = "https://raw.githubusercontent.com/guolindev/eclipse/ 
master/eclipse-inst-win64.exe"; 
downloadBinder.startDownload (url); 
break; 
case R.id.pause download: 
downtLoadBinder.pauseDownLoad () ; 
break; 
case R.id.cancel download: 
downloadBinder.cancelDownload(); 


break; 
default: 
break; 
} 
} 
GOverride 


public void onRequestPermissionsResult(int requestCode, String[] permissions, 
int[] grantResults) { 
switch (requestCode) { 
case 1: 
if (grantResults.length > 0 && grantResults[0] != PackageManager. 
PERMISSION GRANTED) { 
Toast.makeText(this, "拒绝 权限 将 无 法 使 用 程序 ",，Toast .LENGTH_SHORT). 


show(); 
finish(); 
} 
break; 
default: 
} 

} 
GOverride 


protected void onDestroy() { 
Super.onDestroy() ; 
unbindService(connection); 


可 以 看 到 ， 这 里 我 们 首先 创建 了 一 个 ServiceConnection 的 匿名 类 ， 然 后 在 onService- 


Connected() 方 法 中 获取 到 DownloadBinder 的 实例 ， 有 了 这 个 实例 ， 我 们 就 可 以 在 活动 中 调用 
服务 提供 的 各 种 方法 了 。 


接 下 来 看 一 下 onCreate () 方 法 ， 在 这 里 我 们 对 各 个 按钮 都 进行 了 初始 化 操作 并 设置 了 点 击 


事件 , 然 


后 分 别 调用 了 startService() 和 bindSservice() 方 法 来 启动 和 绑 定 服务 。 这 一 点 至 关 


重要 , 因 


为 启动 服务 可 以 保证 DownloadService 一 直 在 后 台 运 行 , 绑 定 服务 则 可 以 让 MainActivity 


和 DownloadService 进行 通信 ， 因 此 两 个 方法 调用 都 必 不 可 少 。 在 onCreate() 方 法 的 最 后 ， 我 
们 还 进行 了 WRITE_EXTERNAL_STORAGE 的 运行 时 权限 申请 ， 因 为 下 载 文件 是 要 下 载 到 SD 卡 的 
Download 目录 下 的 ， 如 果 没 有 这 个 权限 的 话 ， 我 们 整个 程序 都 无 法 正常 工作 。 
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接 下 来 的 代码 就 非常 简单 了 , 在 onClick() 方 法 中 我 们 对 点 击 事件 进行 判断 , 如 果 点 击 了 开 


始 按钮 就 调用 DownloadBinder 的 startDownload() 方 法 ， 如 果 点 击 了 暂停 按钮 就 调用 


pauseDownload() 方 法 ,如 果 点 击 了 取消 按钮 就 调用 cancelDownload() 方 法 ,startDownload() 
方法 中 你 可 以 传 入 任意 的 下 载 地 址 , 这 里 我 使 用 了 一 个 Eclipse 的 下 载 地 址 , 以 此 向 这 个 Android 


平台 上 曾经 最 出 色 的 开发 工具 致敬 。 


另外 还 有 一 点 需要 注意 ,如果 活 动 被 销毁 了 , 那么 一 定 要 记得 对 服务 进行 解 绑 ， 不 然 就 有 可 


能 会 造成 内 存 泄漏 。 这 里 我 们 在 onDestroy( ) 方 法 中 完成 了 解 绑 操 作 。 


现在 只 差 最 后 一 步 了 , 我 们 还 需要 在 AndroidManifestxml 文件 中 声明 使 用 到 的 权限 。 当 然 除 
了 权限 之 外 ，MainActivity 和 DownloadService 也 是 需要 声明 的 ， 不 过 Android Studio 应 该 早 就 帮 


我 们 将 这 两 个 组 件 声明 好 了 ， 如 下 所 示 : 


<manifest xmlns:android="http://schemas.android.com/apk/res/android" 
package="com.example.servicebestpractice"> 


<uses-permission android:name="android.permission.INTERNET" /> 


<uses-permission android:name="android.permission.WRITE EXTERNAL STORAGE" /> 


<application 
android:allowBackup="true" 
android:icon="@mipmap/ic launcher" 
android:label="@string/app_name" 
android:supportsRtl="true" 
android:theme="@style/AppTheme"> 
<activity android:name=".MainActivity"> 
<intent-filter> 
<action android:name="android.intent.action.MAIN" /> 


<category android:name="android.intent.category .LAUNCHER" 


</intent-filter> 
</activity> 


<service 
android:name=" .DownloadService" 
android:enabled="true" 
android:exported="true" /> 
</application> 


</manifest> 


其 中 ， 由 于 我 们 的 程序 使 用 到 了 网 络 和 访问 SD 卡 的 功能 ， 因 此 需要 声明 INTERNET 


WRITE EXTERNAL STORAGE 这 两 个 权限 。 
这 样 所 有 代码 就 都 编写 完了 ， 现 在 终于 可 以 运行 一 下 程序 了 ， 如 图 10.16 所 示 。 


和 


10.6 服务 的 最 佳 实践 一 一 完整 版 的 下 载 示 例 377 


[Ee] Allow 
ServiceBestPractice to 
access photos, media, 


and files on your 
device? 


DENY ALLOW 


图 10.16 申请 访问 SD 卡 权 限 


程序 一 启动 立刻 就 会 申请 访问 SD 卡 的 权限 ,这 里 我 们 点 击 ALLOW ,然后 点 击 Start Download 
按钮 就 可 以 开始 下 载 了 。 下 载 过 程 中 可 以 下 拉 系 统 状态 栏 查看 实时 的 下 载 进度 , 如 图 10.17 所 示 。 


3:48 PM 


Downloading 


WD 


图 10.17 查看 实时 的 下 载 进度 
同时 ， 我 们 还 可 以 点 击 Pause Download 或 Cancel Download， 其 至 于 断 网 操作 来 测试 这 个 下 
载 程 序 的 健壮 性 。 最终 下 载 完 成 后 会 弹出 一 个 Download Success 的 通知 , 然后 我 们 可 以 通过 任意 
一 个 文件 浏览 器 来 查看 一 下 SD 卡 的 Download 目录 ， 如 网 10.18 所 示 。 
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/storage/emulated/0/D' 


4 O 〇 口 


图 10.18 查看 SD 卡 的 Download 目录 

可 以 看 到 ， 文 件 已 经 成 功 下 载 下 来 了 。 

当然 ， 我 们 还 可 以 做 一 些 更 加 丰富 的 操作 ， 比 如 说 再 次 点 击 Start Download 按钮 ， 你 会 发 现 
程序 会 立刻 弹出 一 个 Download Success 的 提示 ， 因 为 它 检测 到 文件 已 经 下 载 完成 了 ,因而 不 会 再 
重新 去 下 载 一 遍 。 如 果 我 们 点 击 Cancel Download 按钮 先 将 下 载 文 件 删除 掉 ， 然 后 再 点 击 Start 
Download 按钮 ， 你 就 会 发 现 程序 又 会 开始 重新 下 载 了 。 

总 体 来 说 , 这 个 下 载 示 例 的 稳定 性 还 是 挺 不 错 的 ,而 且 综 合 性 很 强 , 将 这 个 示例 完全 掌握 了 
之 后 ， 你 的 水 平 肯定 又 更 进一步 了 。 


好 了 ， 最 佳 实践 部 分 到 此 结束 ， 下 面 我 们 就 来 回顾 一 下 本 章 所 学 的 内 容 吧 。 
10.7 ”小 结 与 点 评 


在 本 章 中 ,我 们 学 习 了 很 多 与 服务 相关 的 重要 知识 点 ,包括 Android 多 线程 编程 、 服 务 的 基 
本 用 法 、 服 务 的 生命 周期 、 前 台 服 务 和 IntentService 等 。 这 些 内容 已 经 覆盖 了 大 部 分 你 在 日 常 开 
发 中 可 能 用 到 的 服务 技术 , 再 加 上 最 佳 实践 部 分 学 习 的 下 载 示例 程序 , 相信 以 后 不 管 遇 到 什么 样 
的 服务 难题 ， 你 都 能 从 容 解决 。 

另外 , 本 章 同 样 是 有 里 程 碑 式 的 纪念 意义 的 ， 因 为 我 们 已 经 将 Android 中 的 四 大 组 件 全 部 学 
完 ， 并 且 本 书 的 内 容 也 学 习 一 大 半 了 。 对 于 你 来 说 ， 现 在 你 已 经 脱离 了 Android 初级 开发 者 的 身 
份 ， 并 应 该 具备 了 独立 完成 很 多 功能 的 能 力 。 

那么 后 面 我 们 应 该 再 接 再 厉 , 争取 进一步 提升 自身 的 能 力 ， 所 以 现在 还 不 是 放松 的 时 候 ， 下 
一 章 中 我 们 准备 去 学 习 一 下 Android 特色 开发 的 相关 内 容 。 
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Android 特色 开发 一 一 基于 位 置 的 服务 


现在 你 已 经 学 会 了 非常 多 的 Android 技能 ,并 且 通 过 这 些 技能 你 完全 可 以 编写 出 相当 不 错 的 
应 用 程序 了 。 不 过 本 章 中 ， 我 们 将 要 学 习 一 些 全 新 的 Android 技术 ， 这 些 技术 有 别 于 传统 的 PC 
或 Web 领域 的 应 用 技术 ， 是 只 有 在 移动 设备 上 才能 实现 的 。 

说 到 只 有 在 移动 设备 上 才能 实现 的 技术 ， 很 容易 就 让 人 联想 到 基于 位 置 的 服务 (Location 
Based Service )。 由 于 移动 设备 相 比 于 电脑 可 以 随身 携带 ， 我 们 通过 地 理 定位 的 技术 就 可 以 随时 
得 知 上 自己 所 在 的 位 置 , 从 而 围绕 这 一 点 开发 出 很 多 有 意思 的 应 用 。 本草 中 我 们 就 将 针对 这 一 点 进 
行 讨论 ， 学 习 一 下 基于 位 置 的 服务 究 竞 是 如 何 实 现 的 。 


11.1 基于 位 置 的 服务 简介 


基于 位 置 的 服务 简称 LBS, 随 着 移动 互联 网 的 兴起 , 这 个 技术 在 最 近 的 几 年 里 十 分 火爆 。 其 
实 它 本 身 并 不 是 什么 时 瞩 的 技术 ， 主 要 的 工作 原理 就 是 利用 无 线 电 通讯 网 络 或 GPS 等 定位 方式 
来 确定 出 移动 设备 所 在 的 位 置 ， 而 这 种 定位 技术 早 在 很 多 年 前 就 已 经 出 现 了 。 

那 为 什么 LBS 技术 直到 最 近 几 年 才 开始 流行 呢 ? 这 主要 是 因为 ， 在 过 去 移动 设备 的 功能 极 
其 有 限 ， 即 使 定位 到 了 设备 所 在 的 位 置 , 也 就 仅仅 只 是 定位 到 了 而 已 ,我们 并 不 能 在 位 置 的 基础 
上 进行 一 些 其 他 的 操作 。 而 现在 就 大 大 不 同 了 ， 有 了 Android 系统 作为 载体 ， 我 们 可 以 利用 定位 
出 的 位 置 进行 许多 丰富 多 彩 的 操作 。 比 如 说 天 气 预报 程序 可 以 根据 用 户 所 在 的 位 置 自动 选择 城 
市 , 发 微 博 的 时 候 我 们 可 以 向 朋友 们 晒 一 下 自己 在 哪里 , 不 认识 路 的 时 候 随 时 打开 地 图 就 可 以 查 
询 路 线 ， 等 等 。 

介绍 了 这 么 多 , 相信 你 已 经 按 探 不 住 了 吧 ? 我 们 马上 就 要 开始 本 章 的 学 习 之 旅 , 但 在 开始 之 
前 ， 还 有 一 些 事情 是 你 必须 要 知道 的 。 

首先 你 要 清楚 ,基于 位 置 的 服务 所 围绕 的 核心 就 是 要 先 确 定 出 用 户 所 在 的 位 置 。 通常 有 两 种 
技术 方式 可 以 实现 : 一 种 是 通过 GPS 定位 ,一 种 是 通过 网 络 定位 。GPS 定位 的 工作 原理 是 基于 
手机 内 置 的 GPS 硬件 直接 和 卫星 交互 来 获取 当前 的 经 纬度 信息 ， 这 种 定位 方式 精确 度 非常 高 ， 
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但 缺点 是 只 能 在 室外 使 用 , 室内 基本 无 法 接收 到 卫星 的 信和 号。 网络 定位 的 工作 原理 是 根据 手机 当 
前 网 络 附近 的 三 个 基站 进行 测速 , 以 此 计算 出 手机 和 每 个 基站 之 间 的 距离 , 再 通过 三 角 定 位 确定 
出 一 个 大 概 的 位 置 ， 这 种 定位 方式 精确 度 一 般 ， 但 优点 是 在 室内 室外 都 可 以 使 用 。 

Android 对 这 两 种 定位 方式 都 提供 了 相应 的 API 支持 , 但 是 由 于 一 些 特殊 原因 ，Google 的 网 
络 服务 在 中 国 不 可 访问 ， 从 而 导致 网 络 定位 方式 的 API 失效 。 而 GPS 定位 虽然 不 需要 网 络 ， 但 
是 必须 要 在 室外 才 可 以 使 用 , 因此 你 在 室内 开发 的 时 候 很 有 可 能 会 遇 到 不 管 使 用 哪 种 定位 方式 都 
无 法 成 功 定位 的 情况 。 

基于 以 上 原因 ,我 决定 就 不 在 本 书 中 讲解 Android 原生 定位 API 的 用 法 了 ， 而 是 使 用 一 些 国 
内 第 三 方 公司 的 SDK。 目 前 国内 在 这 一 领域 做 得 比较 好 的 一 个 是 百度 ， 一 个 是 高 德 ， 本 章 我 们 
就 来 学 习 一 下 百度 在 LBS 方面 提供 的 丰富 多 彩 的 功能 。 


11.2 ”申请 API Key 
要 想 在 自己 的 应 用 程序 里 使 用 百度 的 LBS 功能 , 首先 必须 申请 一 个 API Key。 你 得 拥有 一 个 百 
度 账号 才能 进行 申请 ,我 相信 大 多 数 人 早 就 已 经 拥有 了 吧 ? 如 果 你 还 没有 的 话 , 赶 快 去 注册 一 个 吧 。 


有 了 百度 账号 之 后 ， 我 们 就 可 以 申请 成 为 一 名 百度 开发 者 了 ， 登 录 你 的 百度 账号 ， 并 打开 
http://developer.baidu.com/user/reg 这 个 网 址 ， 在 这 里 填写 一 些 注册 信息 即 可 ， 如 图 11.1 所 示 。 


* 类 型 : ® 个 人 ， 公司 
* 开发 者 来 源 : 开 必 者 -|@ 
:开发 者 姓名 : 部 要 本 
:开发 者 简介 : Android 开 发 人 员 。 Tie 
* Email 了 b 址 : A 7@sina.com 修改 

* 手 机 号 : 159****#036 eo 
:验证 码 : 114039 Wi 

开发 者 官方 网 站 : 

品牌 LOGO : 112px*54px， 支 持 PNG/JPG/GIF 格 式 ， 应 用 提交 至 PC 

Web 渠 道 时 进行 展示 
十 


[我 已 阅读 并 同意 百度 开放 云 皇 台 注册 协议 
图 11.1 填写 开发 者 信息 
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只 需 填 写 带 有 “*” 号 的 那 部 分 内 容 就 足够 了 ， 接 下 来 点 击 提交 ， 会 显示 如 图 11.2 所 示 的 
界面 。 


填写 开发 者 信息 验证 邮箱 提交 应 用 / 使 用 开放 云 服务 


验证 邮件 已 经 发 送 至 您 的 邮箱 si********7@sina.com 
请 点 击 邮 件 中 的 激活 链接 完成 验证 ， 即 可 使 用 百度 强大 的 应 用 分 发 渠道 和 丰富 的 开放 云 服务 。 


图 11.2 验证 邮箱 


接着 点 击 “ 去 我 的 邮箱 ”， 将 会 进入 到 我 们 刚才 填写 的 邮箱 当中 ， 这 时 收 件 箱 中 应 该 会 有 一 
封 刚刚 收 到 的 邮件 , 这 就 是 百度 发 送 给 我 们 的 验证 邮件 , 点击 邮件 当中 的 链接 就 可 以 完成 注册 了 ， 
如 图 11.3 所 示 。 


填写 开发 者 信息 验证 邮箱 提交 应 用 / 使 用 开放 云 服务 


@ S 世 


邮箱 验证 成 功 ， 恭 喜 您 成 为 百度 开发 者 ! 
百度 开放 云 平 台 不 仅 将 百度 的 技术 和 大 数据 能 力 开放 给 广大 开发 者 ， 更 有 强力 的 应 用 推广 渠道 ， 
双 剑 合璧 为 您 的 成 功 加 速 ! 


图 11.3 成 为 百度 开发 者 


到 此 一 切 顺 利 ! 这 样 你 就 已 经 成 为 一 名 百度 开发 者 了 。 接 着 访问 http:/lbsyun.baidu.cony 
apiconsole/key 这 个 地 址 ， 然 后 同意 百度 开发 者 协议 ,会 看 到 如 图 11.4 所 示 的 界面 。 


应 用 编号 应 用 名 称 访问 应 用 ( AK ) 应 用 类 别 备注 信息 ( 双击 更 改 ) 应 用 配置 


您 当前 创建 了 0 个 应 用 
图 11.4 百度 LBS 开放 平台 主 界面 


由 于 这 是 一 个 刚刚 注册 的 账号 , 所 以 目前 的 应 用 列表 是 空 的 。 接 下 来 点 击 创建 应 用 就 可 以 去 
申请 API Key 了 ， 应 用 名 称 可 以 随便 填 ， 应 用 类 型 选择 Android SDK， 启 用 服务 保持 默认 即 可 ， 
如 图 11.5 所 示 。 
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应 用 名 称 : LBSTest 


应 用 类 型 : Android SDK 


固 云 检索 API 国 Javascript API 国 Place API v2 
国 Geocoding API v2 圈 IP 定 位 API 图 路 线 交 通 API 
国 Android 地 图 SDK 回 Android 导 航 高 线 SDK 圈 Android 导 航 SDK 
启用 服务 : 

回 甫 去 图 API 回 全 景 静 志 图 API 回 坐标 转换 API 
回 诺 眼 API 圈 全 景 URL API 圈 Android 导 航 HUD SDK 
图 云 送 地 理 编码 API 回 Routematrix API 

* 发 布 版 SHA1 : 。 请 输入 发 布 版 SHAl 

开发 版 SHA1 : 清 输 入 开发 版 SHA1 
* 包 名 : 。 请 输入 包 名 


安全 码 : ”输入 shal 和 包 名 后 自动 生成 


Android SDK 安 全 码 组 成 : SHA1+ 包 名 。( 查 看 详细 配置 方法 ) 


新 申请 的 Mobile 与 Browser 类 型 的 ak 不 再 支持 云 存储 接口 的 访问 ， 如 要 使 用 云 存储 ， 请 申请 Server 类 型 ak。 


图 11.5 创建 应 用 界面 


那么 , 这 个 发 布 版 SHA1 和 开发 版 SHA1 又 是 个 什么 东西 呢 ? 这 是 我 们 申请 APIKey 所 必须 
填写 的 一 个 字段 , 它 指 的 是 打包 程序 时 所 用 签名 文件 的 SHA1 指纹 , 可 以 通过 Android Studio 查看 
到 。 打 开 Android Studio 中 的 任意 一 个 项 目 ， 点 击 右 侧 工具 栏 的 Gradle 一 项 目 名 一 :app 一 Tasks 一 
android， 如 图 11.6 所 示 。 


Gradle projects | 
芒 十 一 台 | 三 至 苹 中 | 序 


T 他 ServiceBestpractice 


ap 3 


上 (© ServiceBestpractice (root) 
Vv ©:app 
™ CaTasks 
了 [Caandroid 
全 androidDependencies 
signingReport 
党 sourceSets 
> [a build 
> [Cahelp 
bp Ca install 
pb [3 other 
p> Ca verification 


图 11.6 查看 内 置 Gradle Tasks 


这 里 展示 了 一 个 Android Studio 项 目 中 所 有 内 置 的 Gradle Tasks ,其 中 signingReport 这 个 Task 
就 可 以 用 来 查看 签名 文件 信息 。 双 击 signingReport， 结 果 如 图 11.7 所 示 。 
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ServiceBestpracticeapp [signingReport] 


22:50:17: Executing external task ’ signingReport’... 


va 


NV X 六 | 唱 
印 杰 国 册 + > 


Configuration on demand is an incubating feature. 

Incremental java compilation is an incubating feature. 
:app:signingReport 

Variant: debug 

Config: debug 

Store: C:\Users\Administrator\. android\debug. keystore 

Alias: AndroidDebugKey 

MD5: 45:62:8A:DE:20:85:67:24:FE:8E:23:81:03:16:81:6A 

SHA1: 91:16:04:30:C0:8B:6E:53:92:47:57:E6:FB:10:EF:08:1B:73:E6:3E 
Valid until: 2044 年 12 月 5 日 星期 一 


Ru 多 Topo 沉 gAndroidMonitor 国 Terminal 国 Q:Messages 


图 11.7 ”signingReport Task 的 执行 结果 


其 中 ，91:16:04:30:C0:8B:6E:53:92:47:57:E6:FB:10:EF:08:1B:73:E6:3E 就 是 我 们 所 需 的 SHA1 


指纹 了 ， 当 然 你 的 Android Studio 中 显示 的 指纹 和 我 的 肯定 是 不 一 样 的 。 


另外 需要 注意 ， 目 前 我 


们 使 用 的 是 debug.keystore 文件 所 生成 的 指纹 ， 这 是 Android 自动 生成 的 一 个 用 于 测试 的 签名 文 
件 。 而 当 你 的 应 用 程序 发 布 时 还 需要 创建 一 个 正式 的 签名 文件 ， 如 果 要 得 到 它 的 指纹 ， 可 以 在 


cmd 中 输入 如 下 命令 : 


keytool -List -v -keystore < 签名 文件 路 径 > 


然后 输入 正确 的 密码 就 可 以 了 。 创 建 签名 文件 的 方法 我 们 将 在 第 


15 章 中 学 习 。 


那么 也 就 是 说 ,现在 得 到 的 这 个 SHA1 指纹 实际 上 是 一 个 开发 版 的 SHA1 指纹 , 不 过 因为 暂 
时 我 们 还 没有 一 个 发 布 版 的 SHA1 指纹 , 因此 这 两 个 值 都 填 成 一 样 的 就 可 以 了 。 最 后 还 剩 下 一 个 
包 名 选项 , 虽然 目前 我 们 的 应 用 程序 还 不 存在 , 但 可 以 先 将 包 名 预定 下 来 ， 比 如 就 叫 com.example. 


lbstest， 这 样 所 有 的 内 容 就 都 填写 完整 了 ， 如 图 11.8 所 示 。 


应 用 名 称 : 


应 用 类 型 : 


启用 服务 : 


* 发布 版 SHAL : 


开发 版 SHA1 : 


LBSTest 


Android SDK Y 


图 云 检索 API 国 Javascript API 国 Place APIv2 
团 Geocoding APIv2 国 IP 定 位 API 国 路 线 交 通 API 

国 Android 地 图 SDK 国 Android 导 航 高 线 SDK 国 Android 导 航 SDK 

回 静态 图 APl 回 全 景 静 坊 图 API 图 坐标 转 找 API 

回 麻 眼 API 国 全 景 URL API 国 Android 导 航 HUD SDK 
回 云 送 地 理 编码 API 国 Routematrix API 


91:16:04:30:C0:8B:6E:53:92:47:57:E6:FB:10:EF:08:1B:73:E6:3E 


91:16:04:30:C0:8B:6E:53:92:47:57:E6:FB:10:EF:08:1B:73:E6:3E 人 @ 输入 正确 


com.example.lbstest 


91:16:04:30:C0:8B:6E:53:92:47:57:E6:FB:10:EF:08:1B:73:E6:3E;com.example.lbstest 
91:16:04:30:C0:8B:6E:53:92:47:57:E6:FB:10:EF:08:1B:73:E6:3E;com.example.lbstest 


Android SDK 安 全 码 组 成 : SHA1+ 包 各 。( 查 看 详细 配置 方法 ) 


新 申请 的 Mobile 与 Browser 类 型 的 ak 不 再 支持 云 存储 接口 的 访问 ， 如 要 使 用 云 存储 ， 请 申请 Server 类 型 ak。 


图 11.8 ”填写 完整 所 有 创建 应 用 的 信息 
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接 下 来 点 击 提交 ， 应 用 就 应 该 创建 成 功 了 ， 如 图 11.9 所 示 。 


应 用 编号 。 应 用 各 称 访问 应 用 (AK ) 应 用 类 别 i 应 用 本 是 
(双击 更 改 
8351285 LBSTest i6VD2fHKM3msMfZtIOXAhFSzDiYGFIwL Android 端 股 置 删除 


图 11.9 查看 已 创建 的 应 用 


其 中 ，i6VD2fHKM3msMfZtIOXAhFSzDiYGFIwL 就 是 申请 到 的 API Key， 有 了 它 就 可 以 进 
行 后 续 的 LBS 开发 工作 了 ， 那 么 我 们 马上 开始 吧 。 


11.3 ”使 用 百度 定位 


现在 正 是 趁 热 打铁 的 好 时 机 ， 新 建 一 个 LBSTest 项 目 ， 包 名 应 该 就 会 自动 被 命名 为 
com.example.lbstest。 另 外 需要 注意 ,本 章 中 所 写 的 代码 建议 你 都 在 手机 上 和 运行， 虽然 模拟 器 中 也 
提供 了 模拟 地 理 位 置 的 功能 ， 但 在 手机 上 可 以 得 到 真实 的 位 置 数据 ， 你 的 感受 会 更 加 深刻 。 


11.3.1 准备 LBS SDK 


在 开始 编码 之 前 ， 我 们 还 需要 先 将 百度 LBS 开放 平台 的 SDK 准备 好 ， 下 载 地 址 是 : 
http://lbsyun.baidu.com/sdk/download。 本 章 中 我 们 会 用 到 基础 地 图 和 定位 功能 这 两 个 SDK， 将 它 
们 勾 先 上， 然后 点 击 “ 开 发 包 ” 下 载 按钮 即 可 ， 如 图 11.10 所 示 。 


选择 并 下 载 相应 功能 的 开发 资源 : 


基础 地 图 ( 合 室 内 图 ) 检索 功能 LBS 云 检索 计算 工具 
© 
«SS (9) A 9 
周边 雷达 定位 功能 导航 功能 ( 有 TTS ) 全 景 图 功能 
© 


图 11.10 下 载 SDK 界面 


下 载 完成 后 对 该 压缩 包 解 压 ， 其 中 会 有 一 个 libs 目录 , 这 里 面 的 内 容 就 是 我 们 所 需要 的 一 切 
了 ， 如 图 11.11 所 示 。 


11.3 使 用 百度 定位 385 


x86_64 
国 BaiduLBS_Androidjar 


图 11.11 压缩 包 libs 目录 下 的 内 容 


1,232 KB 


libs 目录 下 的 内 容 又 分 为 两 部 分 ，BaiduLBS_Android.jar 这 个 文件 是 Java 层 要 使 用 到 的 ， 其 
他 子 目录 下 的 so 文件 是 Native 层 要 用 到 的 。so 文件 是 用 C/C++ 语言 进行 编写 ， 然 后 再 


用 NDK 
编译 出 来 的 。 当 然 这 里 我 们 并 不 需要 去 编写 C/C++ 的 代码 ， 因 为 百度 都 已 经 做 好 了 封装 , 但 是 我 
们 需要 将 libs 目录 下 的 每 一 个 文件 都 放置 到 正确 的 位 置 。 

首先 观察 一 下 当前 的 项 目 结构 ， 你 会 发 现 app 模块 下 面 有 一 个 libs 目录 ,这 里 就 是 用 来 存放 
所 有 的 Jar 包 的 ,我 们 将 BaiduLBS_Android.jar 复制 到 这 里 ， 如 图 11.12 所 示 。 


Cz LBSTest (C 
户 .gradle 
DD ,idea 
[3 app 
户 build 
户 libs 
上 BaiduLBS_Androidjar 
口 src 
目 .gitignore 
[& app.iml 
© build.gradle 
目 proguard-rules.pro 


图 11.12 将 Jar 包 放置 到 1libs 目录 中 


接 下 来 展开 src/main 目录 ， 右 击 该 目录 一 New 一 Directory， 再 创建 一 个 名 为 jniLibs 的 目录 ， 
这 里 就 是 专门 用 来 存放 so 文件 的 ， 然 后 把 压缩 包 里 的 其 他 所 有 目录 直接 复制 到 这 里 ， 如 图 11.13 
所 示 。 


户 src 
DD androidTest 
户 main 
口 java 
DjniLibs 
户 arm64-v8a 
DD armeabi 
户 armeabi-v7a 
口 x86 
口 x86_64 
Cares 
四 AndroidManifestxml 


图 11.13 将 so 文件 放置 到 jniLibs 目录 中 


另外， 虽然 所 有 新 创建 的 项 目 中 ，app/build.gradle 文件 都 会 默认 配置 以 下 这 上 段 声 明 : 


386 第 11 章 Android 特色 开发 一 一 基于 位 置 的 服务 


dependencies { 
compile fileTree(dir: 'libs', include: ['*.jar']) 


} 

这 表示 会 将 libs 目录 下 所 有 以 jar 结尾 的 文件 添加 到 当前 项 目的 引用 中 。 但 是 由 于 我 们 是 直 
接 将 Jar 包 复制 到 libs 目录 下 的 ,并 没有 修改 gradle 文 件 , 因 此 不 会 弹出 我 们 平时 熟悉 的 SyncNow 
提示 。 这 个 时 候 必 须 手动 点 击 一 下 Android Studio 顶部 工具 栏 中 的 Sync 按钮 (图 11.14 中 最 左边 
的 按钮 )， 不 然 项 目 将 无 法 引用 到 Jar 包 中 提供 的 任何 接口 。 


全 H pb 
图 11.14 Android Studio 顶部 工具 栏 


点 击 Sync 按钮 之 后 ，libs 目录 下 的 jar 文件 就 会 多 出 一 个 向 右 的 箭头 ， 这 就 表示 项 目 已 经 能 
引用 到 这 些 Jar 包 了 ， 如 图 11.15 所 示 。 


口 libs 
i BaiduLBS_Androidjar 


图 11.15 Jar 包 引用 成 功 
好 了 ， 这 样 我 们 就 把 LBS 的 SDK 都 准备 好 了 ， 接 下 来 开始 编码 吧 。 


11.3.2 ”确定 自己 位 置 的 经 纬度 
首先 修改 activity main.xml 中 的 代码 ， 如 下 所 示 


<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:orientation="vertical" 
android:layout width="match parent" 
android:layout height="match parent" > 


<TextView 
android:id="@+id/position text view" 
android:layout width="wrap content" 
android:layout height="wrap content" /> 
</LinearLayout> 
布局 文件 中 的 内 容 非常 简单 ， 只 有 一 个 TextView 控件 ， 用 于 稍 后 显示 当前 位 置 的 经 纬度 
信息 [e) 


然后 修改 AndroidManifestxml 文件 中 的 代码 ， 如 下 所 示 : 


<manifest xmlns:android="http://schemas.android.com/apk/res/android" 
package="com.example.lbstest"> 


<uses-permission android:name="android.permission.ACCESS_ COARSE LOCATION"/> 
<uses-permission android:name="android.permission.ACCESS_FINE_LOCATION"/> 


11.3 使 用 百度 定位 387 


<uses-permission android:name="android.permission.ACCESS WIFI_STATE"/> 
<uses-permission android:name="android.permission.ACCESS NETWORK_STATE"/> 
<uses-permission android:name="android.permission.CHANGE WIFI_STATE"/> 
<uses-permission android:name="android.permission.READ PHONE_STATE"/> 
<uses-permission android:name="android.permission.WRITE_ EXTERNAL_ STORAGE"/> 


<uses-permission android:name="android.permission.INTERNET"/> 


<uses-permission android:name="android.permission.MOUNT_UNMOUNT_FILESYSTEMS"/> 


<uses-permission android:name="android.permission.WAKE LOCK"/> 


<application 
android:allowBackup="true" 
android:icon="@mipmap/ic launcher" 
android:label="@string/app_name" 
android:supportsRtl="true" 
android:theme="@style/AppTheme"> 
<meta-data 
android:name="com.baidu.Tlbsapi.API_KEY" 
android:value="i6VD2fHKM3msMfZtIOXAhFSzDiYGFIwL" /> 


<activity android:name=".MainActivity"> 
<intent-filter> 
<action android:name="android.intent.action.MAIN" /> 


<category android:name="android.intent.category.LAUNCHER" /> 


</intent-filter> 
</activity> 


<service android:name="com.baidu.location.f" android:enabled="true" 


android:process=":remote"> 
</service> 
</application> 


</manifest> 


AndroidManifest.xml 文件 改动 比较 多 ， 我们 来 仔细 阅读 一 下 。 可 以 看 到 ,这 里 首先 添加 了 很 
多 行 权限 声明 ， 每 一 个 权限 都 是 百度 LBS SDK 内 部 要 用 到 的 。 然 后 在 <appLication> 标 签 的 内 


I 


部 添加 了 一 个 <meta-data> 标 签 ,这 个 标签 的 android:name 部 分 是 固定 的 ,必须 填 


com,.baidu. 


lbsapi.API_KEY，android:value 部 分 则 应 该 填 人 我 们 在 11.2 节 申 请 到 的 API Key。 最 后 ,还 
需要 再 注册 一 个 LBS SDK 中 的 服务 , 不 用 对 这 个 服务 的 名 字 感 到 疑惑 ， 因为 百度 LBS SDK 中 的 


代码 都 是 混淆 过 的 。 
接 下 来 修改 MainActivity 中 的 代码 ， 如 下 所 示 : 
public class MainActivity extends AppCompatActivity { 
public LocationClient mLocationCLient ; 
private TextView positionText; 
GOverride 
protected void onCreate(Bundle savedInstanceState) { 


super.onCreate(savedInstanceState); 
mLocationClient = new LocationClient(getApplicationContext()); 


mLocationCLient, registerLocationListener(new MyLocationListener()); 
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setContentView(R.layout.activity main); 

positionText = (TextView) findViewById(R.id.position text view); 

List<String> permissionList = new ArrayList<>(); 

if (ContextCompat.checkSelfPermission(MainActivity.this, Manifest. 
permission.ACCESS FINE LOCATION)!= PackageManager.PERMISSION GRANTED) { 
permissionList.add(Manifest.permission.ACCESS FINE LOCATION); 

} 

if (ContextCompat.checkSelfPermission(MainActivity.this, Manifest. 
permission.READ PHONE STATE) != PackageManager.PERMISSION GRANTED) { 
permissionList.add(Manifest.permission.READ PHONE STATE); 

} 

if (ContextCompat.checkSelfPermission(MainActivity.this, Manifest. 
permission.WRITE EXTERNAL STORAGE)!= PackageManager.PERMISSION GRANTED) { 
permissionList.add(Manifest.permission.WRITE EXTERNAL STORAGE); 

} 

if (!permissionList,.isEmpty()) { 
String [] permissions = permissionList.toArray(new String[permissionList. 

size()]); 

ActivityCompat.requestPermissions (MainActivity.this, permissions, 1); 

} else { 
requestLocation(); 

} 

} 


private void requestLocation() { 
mLocationClient.start(); 


} 


@Override 
public void onRequestPermissionsResult(int requestCode, String[] permissions, 
int[] grantResults) { 
switch (requestCode) { 
case 1: 
if (grantResults.length > 0) { 
for (int result : grantResults) { 
if (result != PackageManager.PERMISSION GRANTED) { 
Toast.makeText(this，,， "必须 同 意 所 有 权限 才能 使 用 本 程序 "， 
Toast.LENGTH_SHORT) .show() ; 
finish(); 
return; 
} 
} 
requestLocation(); 
} else { 
Toast.makeText(this, "发 生 未 知 错误 "，Toast.LENGTH SHORT). show(); 
finish(); 
} 
break; 
default: 


} 
public class MyLocationListener implements BDLocationListener { 
GOverride 


public void onReceiveLocation(BDLocation Location) { 
runOnUiThread(new Runnable() { 
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@Override 
public void run() { 
StringBuilder currentPosition = new StringBuilder(); 
currentPosition.append(" 纬 度 :").append(location.getLatitude()). 
append("\n"); 
currentPosition.append(" 经 线 : ").append(location.getLongitude()). 
append("\n"); 
currentPosition.append(" 定 位 方式 : ") ; 
if (location.getLocType() == BDLocation.TypeGpsLocation) { 
currentPosition.append("GPS"); 
} else if (location.getLocType() == 
BDLocation.TypeNetWorkLocation) { 
currentPosition.append(" 网 络 ")， 


positionText.setText(currentPosition); 


}); 
} 


@Override 
public void onConnectHotSpotMessage(String s, int i) { 


} 


} 


可 以 看 到 , 在 onCreate() 方 法 中 ,我 们 首先 创建 了 一 个 LocationClient 的 实例 ， 
LocationClient 的 构建 函数 接收 一 个 Context 参数 , 这 里 调用 getApplicationContext() 方 
法 来 获取 一 个 全 局 的 Context 参数 并 传人 。 然 后 调用 LocationCLient 的 registerLocation- 
Listener() 方 法 来 注册 一 个 定位 监听 器 ， 当 获取 到 位 置信 息 的 时 候 ， 就 会 回调 这 个 定位 监听 器 。 

接 下 来 看 一 下 这 里 运行 时 权限 的 用 法 ， 由 于 我 们 在 AndroidManifest.xml 中 声明 了 很 多 权限 ， 
参考 一 下 7.2.1 小 节 中 的 危险 权限 表格 可 以 发 现 ， 其 中 ACCESS COARSE LOCATION 、ACCESS _ 
FINE LOCATION、READ PHONE STATE、WRITE EXTERNAL STORAGE 这 4 个 权限 是 需要 进行 运行 
时 权限 处 理 的 , 不 过 由 于 ACCESS COARSE LOCATION 和 ACCESS FINE LOCATION 都 属于 同一 个 
权限 组 , 因此 两 者 只 要 申请 其 一 就 可 以 了 。 那么 怎样 才能 在 运行 时 一 次 性 申请 3 个 权限 呢 ? 这 里 
我 们 使 用 了 一 种 新 的 用 法 , 首先 创建 一 个 空 的 List 集合, 然后 依次 判断 这 3 个 权限 有 没有 被 授权 ， 
如 果 没 被 授权 就 添加 到 List 集合 中 ， 最 后 将 List 转换 成 数组 ， 再 调用 ActivityCompat . 
requestPermissions () 方 法 一 次 性 申请 。 

除 此 之 外 ，onRequestPermissionsResutLt() 方 法 中 对 权限 申请 结果 的 逻辑 处 理 也 和 之 前 
有 所 不 同 ,这 次 我 们 通过 一 个 循环 将 申请 的 每 个 权限 都 进行 了 判断 , 如果 有 任何 一 个 权限 被 拒绝 ， 
那么 就 直接 调用 finish() 方 法 关闭 当前 程序 ， 只 有 当 所 有 权限 都 被 用 户 同 意 了 ， 才 会 调用 
requestLocation() 方 法 开始 地 理 位 置 定位 。 

requestLocation() 方 法 中 的 代码 比较 简单 ,只 是 调用 了 一 下 LocationClient 的 start() 
方法 就 能 开始 定位 了 。 定 位 的 结果 会 回调 到 我 们 前 面 注册 的 监听 器 当中 ， 也 就 是 
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MyLocationListener。 观 察 一 下 MyLocationListener 的 onReceiveLocation() 方 法 中 ， 在 这 里 我 
们 通过 BDLocation 的 getLatitude() 方 法 获取 当前 位 置 的 纬度 ， 通 过 getLongitude() 方 法 获 


取 当 前 位 置 的 经 度 ， 通 过 getLocType( ) 方 法 获取 当前 的 定位 方式 ， 
串 ， 显 示 到 TextView 上 面 。 


最 终 将 结果 组 装 成 一 个 字符 


现在 我 们 可 以 来 运行 一 下 程序 了 ， 如 图 11.16 所 示 。 训 无 疑问 ， 


打开 程序 首先 就 会 弹出 运行 


时 权限 的 申请 对 话 框 ,注意 看 对 话 框 的 底部 ,提示 我 们 一 共有 3 项 权限 申请 ， 当 前 是 第 1 项, 授 
权 了 第 1 项 后 就 会 显示 第 2 项 ,这 里 我 们 全 部 点 击 允 许 , 然 后 就 会 立刻 开始 定位 了 ,结果 如 图 11.17 


所 示 。 


要 允许 LBSTest 使 用 此 
设备 的 位 置信 息 吗 ? 


4 


图 11.16 运行 时 权限 申请 对 话 放 图 11.17 
可 以 看 到 ,设备 当前 的 经 纬度 信息 已 经 成 功 定位 出 来 了 。 


不 过 ， 在 默认 情况 下 ， 调 用 LocationClient 的 start () 方 法 只 会 定 
速 移动 中 ， 怎 样 才 能 实时 更 新 当前 的 位 置 呢 ? 为 此 ， 百 度 LBS SDK 


Iml 


PE Esl 
LBSTest 
网 络 “ 


O 〇 四] 


地 理 位 置 定位 的 结果 


位 一 次 ， 如 果 我 们 正在 快 
提供 了 一 系列 的 设置 方法 ， 


来 允许 我 们 更 改 默认 的 行为 ， 修 改 MainActivity 中 的 代码 ， 如 下 所 示 : 


public class MainActivity extends AppCompatActivity { 


private void requestLocation() { 
initLocation(); 
mLocationClient.start(); 


} 


private void initLocation(){ 


LocationClientOption option = new LocationClientOption(); 


option.setScanSpan(5000); 
mLocationClient.setLocOption (option); 
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@Override 

protected void onDestroy() { 
super.onDestroy(); 
mLocationClient. stop(); 


} 


} 

这 里 增加 了 一 个 initLocation() 方 法 ,在 initLocation() 方 法 中 我 们 创建 了 一 个 
LocationClient0ption 对 象 ， 然 后 调用 它 的 setScanSpan() 方 法 来 设置 更 新 的 间隔 。 这 里 传 
和 信 了 5000， 表 示 每 5 秒 钟 会 更 新 一 下 当前 的 位 置 。 
最 后 要 记得 ,在 活动 被 销毁 的 时 候 一 定 要 调用 LocationClient 的 stop() 方 法 来 停止 定位 ， 
不 然 程序 会 持续 在 后 台 不 停 地 进行 定位 ， 从 而 严重 消耗 手机 的 电量 。 

现在 重新 运行 一 下 程序 , 然后 拿 着 手机 随处 移动 , 你 会 发 现 界面 上 的 经 纬度 信息 也 会 跟着 一 
起 变化 的 。 


11.3.3 ”选择 定位 模式 

还 记得 在 本 章 刚 开 始 的 时 候 说 过 ,Android 中 主要 有 两 种 定位 方式 吗 ?” 一 种 是 通过 GPS 定位 ， 
一 种 是 通过 网 络 定位 。 而 从 上 一 小 节 中 的 例子 中 应 该 可 以 看 出 ,我 们 一 直 是 使 用 的 网 络 定位 。 那 
么 如 何 才能 切换 到 精确 度 更 高 的 GPS 定位 呢 ? 本 小 节 我 们 就 来 学 习 一 下 。 

首先 ，GPS 定位 功能 必须 要 由 用 户主 动 去 启用 才 行 ， 不 然 任 何 应 用 程序 都 无 法 使 用 GPS 获 
取 到 手机 当前 的 位 置信 息 。 进 入 手机 的 设置 一 位 置信 息 ， 如 图 11.18 所 示 。 


Google Play 服 务 
低 电 耗 
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LBSTest 
EE 高 电 耗 


搜狗 输入 法 
e 低 电 耗 


电话 
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图 11.18 ”位置 信息 设置 界面 
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我 们 可 以 通过 顶部 的 开关 来 控制 定位 功能 是 开启 还 是 关闭 , 男 外 ， 点击“ 模式 ”可 以 选择 具 
体 的 定位 模式 ， 如 图 11.19 所 示 。 


4 


拟 ”位 置信 息 模式 


精确 度 
使 用 GPS、WLAN、 蓝 牙 或 移动 网 络 确定 位 置 @ 
节 电 
使 用 WLAN、 蓝 牙 或 移动 网 络 确定 位 置 (©) 
仅 限 设备 O 


使 用 GPS 确定 位 置 


图 11.19 选择 具体 的 定位 模式 


其 中 , 高 精确 度 模式 表示 人 允许 使 用 GPS 、 无 线 网 络 、 蓝 牙 或 移动 网 络 来 进行 定位 ， 节 电 模 式 
表示 仅 允 许 使 用 无 线 网 络 、 蓝 牙 或 移动 网 络 来 进行 定位 ， 而 仅 限 设备 模式 表示 仅 允 许 使 用 GPS 
来 进行 定位 。 也 就 是 说 ， 如 果 我 们 想 要 使 用 GPS 定位 功能 ， 这 里 必须 要 选择 高 精确 度 模 式 ， 或 
者 仅 限 设备 模式 。 

当然 ,你 并 不 需要 担心 一 旦 启用 GPS 定位 功能 后 ,手机 的 电量 就 会 直线 下 滑 ,， 这 只 是 表明 你 
已 经 同意 让 应 用 程序 来 对 你 的 手机 进行 GPS 定位 了 ， 但 只 有 当 定 位 操作 真正 开始 的 时 候 ， 才 会 
影响 到 手机 的 电量 。 

开启 了 GPS 定位 功能 之 后 , 再 回来 看 一 下 代码 。 我们 可 以 在 initLocation( ) 方 法 中 对 百度 
LBS SDK 的 定位 模式 进行 指定 ,一 共有 3 种 模式 可 选 : Hight_ Accuracy 、Battery_Saving 和 
Device_Sensors。Hight Accuracy 表示 高 精确 度 模 式 ， 会 在 GPS 信号 正常 的 情况 下 优先 使 用 GPS 
定位 ， 在 无 法 接收 GPS 信号 的 时 候 使 用 网 络 定 位 。Battery_Saving 表示 节 电 模式 ， 只 会 使 用 网 络 
进行 定位 。Device_Sensors 表示 传感器 模式 ， 只 会 使 用 GPS 进行 定位 。 其 中 ，Hight_Accuracy 是 
默认 的 模式 ,也 就 是 说 ,我 们 即使 不 修改 任何 代码 ， 只 要 拿 着 手机 走 到 室外 去 ,让 手机 可 以 接收 
到 GPS 信号 ， 就 会 自动 切换 到 GPS 定位 模式 了 。 

当然 我 们 也 可 以 强制 指定 只 使 用 GPS 进行 定位 ， 修 改 MainActivity 中 的 代码 ， 如 下 所 示 : 


public class MainActivity extends AppCompatActivity { 
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private void initLocation(){ 
LocationClientOption option = new LocationClientOption(); 


option.setScanSpan(5000); 
option.setLocationMode (LocationClientOption.LocationMode.Device Sensors); 


mLocationClient.setLocOption(option); 


} 
这 里 调用 了 setLocationMode() 方 法 来 将 定位 模式 指定 成 传感器 模式 ， 也 就 是 说 只 能 使 用 
GPS 进行 定位 。 重 新 运行 一 下 程序 ， 然 后 拿 着 你 的 手机 走 到 室外 去 ， 结 果 如 图 11.20 所 示 。 


9 A1654 
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纬度 : 31.249852 
经 线 : 120.698656 
定位 方式 ; GPS 


图 11.20 GPS 定位 的 结果 


11.3.4 ”看 得 懂 的 位 置信 息 


话说 回来 ,刚才 我 们 虽然 成 功 获 取 到 了 设备 当前 位 置 的 经 纬度 信息 , 但 遗憾 的 是 , 这 种 经 纬 
度 的 值 一 般 人 是 根本 看 不 懂 的 ， 相 信 谁 也 无 法 立刻 答 出 南 纬 25 度 、 东 经 148 度 是 什么 地 方 吧 ? 
为 了 能 够 更 加 直观 地 阅读 ， 我 们 还 需要 学 习 一 下 如 何 获 取 看 得 懂 的 位 置信 息 。 


滁 运 的 是 ， 百 度 LBS SDK 在 这 方面 提供 了 非常 好 的 支持 ， 我 们 只 需要 进行 一 些 简 单 的 接口 
调用 就 能 得 到 当前 位 置 各 种 丰富 的 地 址 信息 ， 下 面 就 来 一 起 看 一 下 吧 。 


修改 MainActivity 中 的 代码 ， 如 下 所 示 : 


public class MainActivity extends AppCompatActivity { 


~ 


private void initLocation(){ 
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LocationClientOption option = new LocationClientOption(); 
option.setScanSpan(5000); 

option.setIsNeedAddress (true); 
mLocationClient.setLocOption(option); 


public class MyLocationListener implements BDLocationListener { 


@Override 
public void onReceiveLocation(BDLocation location) { 
runOnUiThread(new Runnable() { 
@Override 
public void run() { 

StringBuilder currentPosition = new StringBuilder(); 

currentPosition.append(" 纬 度 :").append(location.getLatitude()). 
append("\n"); 

currentPosition.append(" 经 线 :") .append(Location,getLongitude() ) , 
append("\n"); 

currentPosition.append(" 国 家 : ") .append(Location.getCountry() ) . 
append("\n"); 

currentPosition.append(" 省 : ") .append(Location.getProvince()) . 
append("\n"); 

currentPosition.append(" 市 : ") .append(Location.getCity() ) . 
append("\n"); 

currentPosition.append(" 区 : ").append(Tlocation.getDistrict()). 
append("\n"); 

currentPosition.append(" 街 道 : ").append(location.getStreet()). 
append("\n"); 

currentPosition.append(" 定 位 方式 : ") ; 

if (location.getLocType() == BDLocation.TypeGpsLocation) { 
currentPosition.append("GPS"); 

} else if (location.getLocType() == 
BDLocation.TypeNetWorkLocation) { 
currentPosition.append(" 网 络 ")，; 

} 

positionText.setText(currentPosition); 


} 


首先 在 ijnitLocation() 方 法 中 ,我 们 调用 了 LocationClientOption 的 setIsNeedAddress() 
方法 ， 并 传 入 true， 这 就 表示 我 们 需要 获取 当前 位 置 详细 的 地 址 信息 。 

接 下 来 在 MyLocationListener 的 onReceiveLocation() 方 法 就 可 以 获取 到 各 种 丰富 的 地 址 
信息 了 , 调用 getCountry() 方 法 可 以 得 到 当前 所 在 国家 , 调用 getProvince() 方 法 可 以 得 到 当 
前 所 在 省 份 , 以 此 类 推 。 另 外 还 有 一 点 需要 注意 ,由 于 获取 地 址 信息 一 定 需要 用 到 网 络 ， 因 此 即 
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使 我 们 将 定位 模式 指定 成 了 Device_Sensors， 也 会 自动 开启 网 络 定 位 功能 。 
现在 重新 运行 一 下 程序 ， 结 果 如 图 11.21 所 示 。 
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图 11.21 获取 到 当前 位 置 的 地 址 信息 


可 以 看 到 , 手机 当前 位 置 的 地 址 信息 已 经 成 功 显 示 出 来 了 。 如 果 你 带 着 手机 移动 了 较 远 的 距 
离 ， 界面 上 显示 的 位 置 也 会 跟着 一 起 变化 的 。 
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现在 手机 地 图 的 应 用 真 的 可 以 算得 上 是 非常 广泛 了 ， 和 PC 上 的 地 图 相 比 ， 手 机 地 图 能 够 随 
时 随地 进行 查看 , 并且 轻 松 构 建 出 行路 线 , 使 用 起 来 明显 更 加 地 方便 。 但 是 你 有 没有 想 过 ,其实 
我 们 在 自己 的 应 用 程序 里 也 是 可 以 加 入 地 图 功能 的 ， 比 如 优 步 中 使 用 的 就 是 百度 地 图 。 本 节 我 们 
就 来 学 习 一 下 这 方面 的 知识 。 


11.4.1 让 地 图 显示 出 来 


由 于 在 上 一 节 中 我 们 已 经 将 LBS SDK 全 部 准备 好 了 ， 其 中 就 包括 了 地 图 功能 ， 因 此 这 里 就 
不 用 再 去 下 载 百 度 地 图 的 SDK 了 。 

那么 我 们 直接 在 LBSTest 项 目的 基础 上 进行 开发 ， 修 改 activity_main.xml 中 的 代码 ， 如 下 
所 示 : 


<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:orientation="vertical" 
android:layout width="match parent" 
android:layout height="match parent" > 
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<TextView 


android:id="@+id/position text view" 
android:layout width="wrap_ content" 
android:layout height="wrap content" 
android:visibility="gone" /> 


<com.baidu.mapapi.map.MapView 


android:id="@+id/bmapView" 
android:Tlayout width="match_parent" 
android:layout height="match _ parent" 
android:clickable="true" /> 


</LinearLayout> 


这 里 在 布局 文件 中 新 放置 了 一 个 MapView 控件 ， 并 让 它 填 充满 整个 屏幕 。 这 个 MapView 是 


由 百度 提供 的 自 定 义 控件 ， 所 以 在 使 用 它 的 时 候 需 要 将 完整 的 包 名 加 上 。 男 外 ,之 前 用 于 显示 定 


位 信息 的 TextView 现在 暂时 用 不 到 了 ， 我 们 将 它 的 visibility 属性 指定 成 gone， 让 它 在 界面 


上 隐藏 起 来 。 


接 下 来 修改 MainActivity 中 的 代码 ， 如 下 所 示 : 


public class MainActivity extends AppCompatActivity { 


private MapView mapView; 


@Override 
protected void onCreate(Bundle savedInstanceState) { 


super.onCreate(savedInstanceState); 

mLocationClient = new LocationClient(getApplicationContext()); 
mLocationClient.registerLocationListener(new MyLocationListener()); 
SDKInitializer.initialize(getApplicationContext()); 
setContentView(R.layout.activity main); 

mapView = (MapView) findViewById(R.id.bmapView); 


@Override 
protected void onResume() { 


} 


super .onResume(); 
mapView.onResume(); 


@Override 
protected void onPause() { 


} 


super .onPause(); 
mapView.onPause(); 


@Override 
protected void onDestroy() { 


super.onDestroy(); 
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mLocationClient. stop(); 
mapView.onDestroy(); 


} 

可 以 看 到 , 这 里 的 代码 也 非常 简单 。 首先 需要 调用 SDKInitializer 的 initialize() 方 法 来 进 
行 初始 化 操作 ，initialize() 方 法 接收 一 个 Context 参数 ， 这 里 我 们 调用 getApplication- 
Context ( ) 方 法 来 获取 一 个 全 局 的 Context 参数 并 传 入 ,注意 初始 化 操作 一 定 要 在 setContent- 
View() 方 法 前 调用 ， 不 然 的 话 就 会 出 错 。 接 下 来 我 们 调用 findViewById() 方 法 获取 到 了 
MapView 的 实例 ， 这 个 实例 在 后 面 的 功能 当中 还 会 用 到 。 

另外 还 需要 重 写 onResume() 、onPause() 和 onDestroy() 这 3 个 方法 , 在 这 里 对 MapView 
进行 管理 ， 以 保证 资源 能 够 及 时 地 得 到 释放 。 

好 了 , 就 是 这 么 简单 。 现在 重新 运行 一 下 程序 ， 百度 地 图 就 应 该 成 功 显示 出 来 了 , 如 图 11.22 
所 示 。 
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图 11.22 让 百度 地 图 显示 出 来 


11.4.2 ”移动 到 我 的 位 置 


地 图 是 成 功 显示 出 来 了 , 但 也 许 这 并 不 是 你 想 要 的 。 因 为 这 是 一 张 默认 的 地 图 ， 显 示 的 是 北 
京 市 中 心 的 位 置 ， 而 你 可 能 希望 看 到 更 加 精细 的 地 图 信息 ， 比 如 说 自己 所 在 位 置 的 周边 环境 。 显 
然 , 通过 缩放 和 移动 的 方式 来 慢 慢 找到 自己 的 位 置 是 一 种 很 思春 的 做 法 。 那 么 本 小 节 我 们 就 来 学 
习 一 下 ， 如 何 才能 在 地 图 中 快速 移动 到 自己 的 位 置 。 
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百度 LBS SDK 的 API 中 提供 了 一 个 BaiduMap 类 ， 它 是 地 图 的 总 控制 器 ， 调 用 MapView 的 
getMap() 方 法 就 能 获取 到 BaiduMap 的 实例 ， 如 下 所 示 : 


BaiduMap baiduMap = mapView.getMap(); 


有 了 BaiduMap 后 ， 我 们 就 能 对 地 图 进行 各 种 各 样 的 操作 了 ， 比 如 设置 地 图 的 缩放 级 别 以 及 
将 地 图 移动 到 某 一 个 经 纬度 上 。 

百度 地 图 将 缩放 级 别 的 取 值 范围 限定 在 3 到 19 之 间 ， 其 中 小 数 点 位 的 值 也 是 可 以 取 的 , 值 
越 大 ， 地 图 显示 的 信息 就 越 精细 。 比 如 我 们 想 要 将 缩放 级 别 设置 成 12.5， 就 可 以 这 样 写 : 


MapStatusUpdate update = MapStatusUpdateFactory.zoomTo(12.5f); 

baiduMap.animateMapStatus (update); 

其 中 MapStatusUpdateFactory 的 zoomTo ( ) 方 法 接收 一 个 float 型 的 参数 ， 就 是 用 于 设置 缩 
放 级 别 的 ,这 里 我 们 传人 12.5f。zoomTo ( ) 方 法 返回 一 个 MapStatusUpdate 对 象 , 我 们 把 这 个 对 
象 传 人 BaiduMap 的 animateMapStatus () 方 法 当中 即 可 完成 缩放 功能 。 


那么 怎样 才能 让 地 图 移动 到 某 一 个 经 纬度 上 呢 ? 这 就 需要 借助 LatLng 类 了 。 其 实 LatLng 
并 没有 什么 太 多 的 用 法 ， 主 要 就 是 用 于 存放 经 纬度 值 的 , 它 的 构造 方法 接收 两 个 参数 ， 第 一 个 参 
数 是 纬度 值 ， 第 二 个 参数 是 经 度 值 。 之 后 调用 MapStatusUpdateFactory 的 newLatLng () 方 法 将 
LatLng 对 象 传人 , newLatLng () 方 法 返回 的 也 是 一 个 MapStatusUpdate 对 象 , 我 们 再 把 这 个 对 
象 传 人 BaiduMap 的 animateMapStatus () 方 法 当中 ， 就 可 以 将 地 图 移动 到 指定 的 经 纬度 上 了 ， 
写法 如 下 : 

LatLng ll = new LatLng(39.915, 116.404); 


MapStatusUpdate update = MapStatusUpdateFactory.newLatLng(1l); 
baiduMap.animateMapStatus (update); 


上 述 代 码 就 实现 了 将 地 图 移动 到 北纬 39.915 度 、 东 经 116.404 度 这 个 位 置 的 功能 。 

了 解 了 这 些 知识 之 后 ， 接 下 来 再 去 实现 将 地 图 快速 移动 到 自己 位 置 的 功能 就 变 得 非常 简单 
了 。 首先 我 们 可 以 利用 在 11.3 节 中 所 学 的 定位 技术 来 获得 自己 当前 位 置 的 经 纬度 , 之 后 再 按照 上 
述 的 方法 来 将 地 图 移动 到 指定 的 位 置 就 可 以 了 。 

那么 下 面 我 们 就 来 继续 完善 LBSTest 这 个 项 目 ， 加 入 “移动 到 我 的 位 置 ”这 个 功能 。 修 改 
MainActivity 中 的 代码 ， 如 下 所 示 : 


public class MainActivity extends AppCompatActivity { 


private BaiduMap baiduMap; 
private boolean isFirstLocate = true; 


@Override 
protected void onCreate(Bundle savedInstanceState) { 
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} 


} 


super.onCreate(savedInstanceState); 

mLocationClient = new LocationClient(getApplicationContext()); 
mLocationCLient, registerLocationListener(new MyLocationListener()); 
SDKInitializer.initialize(getApplicationContext()); 
setContentView(R.layout.activity main); 

mapView = (MapView) findViewById(R.id.bmapView); 

baiduMap = mapView.getMap(); 


private void navigateTo(BDLocation location) { 


} 


if (isFirstLocate) { 
LatLng LL = new LatLng(location.getLatitude(), location.getLongitude()); 
MapStatusUpdate update = MapStatusUpdateFactory.newLatLng(11); 
baiduMap.animateMapStatus (update); 
update = MapStatusUpdateFactory.zoomTo(16f); 
baiduMap .animateMapStatus (update); 
isFirstLocate = false; 


public class MyLocationListener implements BDLocationListener { 


@Override 
public void onReceiveLocation(BDLocation location) { 
if (Location.getLocType() == BDLocation.TypeGpsLocation 
|| Location.getLocType() == BDLocation.TypeNetWorkLocation) { 
navigateTo(location); 


这 里 并 没有 新 增多 少 代码 ， 主 要 是 加 入 了 一 个 navigateTo() 方 法 。 这 个 方法 中 的 代码 也 很 
好 理解 ， 先 是 将 BDLocation 对 象 中 的 地 理 位 置信 息 取 出 并 封装 到 LatLng 对 象 中 ,然后 调用 
MapStatusUpdateFactory 的 newLatLng() 方 法 并 将 LatLng 对 象 传人 , 接着 将 返回 的 MapStatus- 
Update 对 象 作 为 参数 传人 到 BaiduMap 的 animateMapStatus() 方 法 当中 ， 和 上 面 介 绍 的 用 法 


是 一 模 一 样 的 。 并 且 这 里 为 了 让 地 图 信息 可 以 显示 得 更 加 丰富 一 些 ， 我 们 将 缩放 级 别 设置 成 了 


16。 男 外 还 有 一 点 需要 注意 ， 上 述 代码 当中 我 们 使 用 了 一 个 ijsFirstLocate 变量 ， 这 个 变量 的 
作用 是 为 了 防止 多 次 调用 animateMapStatus() 方 法 , 因为 将 地 图 移动 到 我 们 当前 的 位 置 只 需要 


在 程序 第 


一 次 定位 的 时 候 调用 一 次 就 可 以 了 。 


写 好 了 navigateTo() 方 法 之 后 ， 剩 下 的 事情 就 简单 了 ， 当 定位 到 设备 当前 位 置 的 时 候 ， 我 
们 在 onReceiveLocation() 方 法 中 直接 把 BDLocation 对 象 传 给 navigateTo( ) 方 法 ,这 样 就 能 
够 让 地 图 移动 到 设备 所 在 的 位 置 了 。 


现在 重新 运行 一 下 程序 ， 结 果 如 图 11.23 所 示 。 
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图 11.23 ”将 地 图 移动 到 设备 所 在 的 位 置 


11.4.3 让 “我 ”显示 在 地 图 上 


现在 我 们 已 经 可 以 让 地 图 显示 我 们 周边 的 环境 了 , 但 是 相信 在 你 平时 使 用 手机 地 图 时 应 该 会 


注意 到 , 通常 情况 下 手机 地 图 上 应 该 都 会 有 一 个 小 光标 ， 


用 于 显示 设备 当前 所 在 的 位 置 ,并且 如 


果 设 备 正在 移动 的 话 , 那么 这 个 光标 也 会 跟着 一 起 移动 。 那 么 我 们 现在 就 继续 对 现 有 代码 进行 扩 


展 ， 让 “我 ”能 够 显示 在 地 图 上 。 


百度 LBS SDK 当中 提供 了 一 个 MyLocationData.Builder 类 , 这 个 类 是 用 来 封装 设备 当前 
所 在 位 置 的 ， 我 们 只 需 将 经 纬度 信息 传人 到 这 个 类 的 相应 方法 当中 就 可 以 了 ， 如 下 所 示 : 


MyLocationData.Builder locationBuilder = new MyLocationData.Builder(); 


LocationBuiLder.Latitude(39.915) ; 
locationBuilder.longitude(116.404); 


MyLocationData.Builder 类 还 提供 了 一 个 build( 


) 方 法 , 当 我 们 把 要 封装 的 信息 都 设置 完 


成 之 后 ， 只 需要 调用 它 的 build() 方 法 ， 就 会 生成 一 个 MyLocationData 的 实例 ， 然 后 再 将 这 个 
实例 传人 到 BaiduMap 的 setMyLocationData() 方 法 当中 ,就 可 以 让 设备 当前 的 位 置 显示 在 地 


图 上 了 ， 写 法 如 下 : 


MyLocationData LocationData = locationBuilder.build(); 


baiduMap.setMyLocationData(locationData); 


大 体 思路 就 是 这 个 样子 ,下面 我 们 开始 来 实现 一 下 , 修改 MainActivity 中 的 代码 , 如 下 所 示 : 


public class MainActivity extends AppCompatActivity { 
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} 


GOverride 
protected void onCreate(Bundle savedInstanceState) { 


} 


super.onCreate(savedInstanceState); 

mLocationClient = new LocationClient(getApplicationContext()); 
mLocationCLient, registerLocationListener(new MyLocationListener()); 
SDKInitializer.initialize(getApplicationContext()); 
setContentView(R.layout.activity main); 

mapView = (MapView) findViewById(R.id.bmapView); 

baiduMap = mapView.getMap(); 

baiduMap.setMyLocationEnabled (true); 


private void navigateTo(BDLocation location) { 


} 


if (isFirstLocate) { 
LatLng ll = new LatLng(location.getLatitude(), location.getLongitude()); 
MapStatusUpdate update = MapStatusUpdateFactory.newLatLng (ll); 
baiduMap.animateMapStatus (update); 
update = MapStatusUpdateFactory.zoomTo(16f); 
baiduMap.animateMapStatus (update); 
isFirstLocate = false; 
} 
MyLocationData.Builder locationBuilder = new MyLocationData.Builder(); 
locationBuilder.latitude(location.getLatitude()); 
LocationBuiLder.Longitude(Location.getLongitude() ) ; 
MyLocationData LocationData = locationBuilder.build!(); 
baiduMap .setMyLocationData(LocationData) ; 


GOverride 
protected void onDestroy() { 


super.onDestroy(); 

mLocationClient. stop(); 
mapView.onDestroy(); 
baiduMap.setMyLocationEnabled (false); 


可 以 看 到 , 在 navigateTo() 方 法 中 , 我 们 添加 了 MyLocationData 的 构建 逻辑 ,将 Location 


中 包含 的 经 度 和 绎 


度 分 别 封装 到 了 MyLocationData.Builder 当中 , 最 后 把 MyLocationData 设置 到 


了 BaiduMap 的 setMyLocationData() 方 法 当中 。 注意 这 上 段 逻辑 必须 写 在 isFirstLocate 这 个 


if 条 件 语句 的 外 


面 ， 因 为 让 地 图 移动 到 我 们 当前 的 位 置 只 需要 在 第 一 次 定位 的 时 候 执行 ,但 是 


设备 在 地 图 上 显示 的 位 置 却 应 该 是 随 着 设备 的 移动 而 实时 改变 的 。 


男 外 ,根据 百度 地 图 的 限制 ， 如 果 我 们 想 要 使 用 这 一 功能 ,一 定 要 事先 调用 BaiduMap 的 


setMyLocationE 


nabled() 方 法 将 此 功能 开启 ,否则 设备 的 位 置 将 无 法 在 地 图 上 显示 。 而 在 程序 


退出 的 时 候 ， 也 要 记得 将 此 功能 给 关闭 掉 。 
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就 是 这 么 简单 ， 现 在 重新 运行 一 下 程序 ， 结 果 如 图 11.24 所 示 。 
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图 11.24 让 “我 ”显示 在 地 图 上 

这 样 的 话 ， 用 户 就 可 以 非常 清晰 地 看 出 自己 当前 是 在 哪里 了 。 

关于 百度 LBS SDK 的 用 法 我 就 准备 介绍 这 么 多 ， 现 在 你 已 经 算是 成 功 和 人 门 了 。 如 果 想 要 更 
加 深入 地 研究 百度 LBS 的 各 种 用 法 ， 可 以 到 官方 网 站 上 面 参 考 开 发 指南 ， 地 址 是 : 
http://lbsyun.baidu.com。 男 外 ,百度 LBS SDK 的 版 本 未 来 随时 都 有 可 能 更 新 , 也许 更 新 之 后 会 导 
致 书 上 的 例子 无 法 正常 运行 , 因此 除了 照 着 图 书 学 习 之 外 , 根据 官网 的 开发 指南 来 进行 学 习 也 是 
非常 重要 的 ， 因 为 官方 文档 永远 都 是 最 新 的 。 

好 了 , 本 章 的 主体 内 容 到 这 里 就 结束 了 。 下 面 我 们 将 再 次 进入 本 书 的 特殊 环节 ,学 习 一 下 关 
于 Git 的 高 级 用 法 。 


11.5 ”Git 时 间 版 本 控制 工具 的 高 级 用 法 


现在 的 你 对 于 Git 应 该 完全 不 会 感到 陌生 了 吧 ， 通 过 了 之 前 两 节 内 容 的 学 习 ， 你 已 经 掌握 了 
很 多 Git 中 党 用 的 命令 ， 像 提交 代码 这 种 简单 的 操作 相信 肯定 是 难 不 倒 你 的 。 

那么 打开 Git Bash， 并 进入 到 LBSTest 这 个 项 目的 根 目 录 ， 然 后 执行 提交 操作 : 

git init 


git add . 
git commit ~—m "First Commit." 


这 样 就 将 准备 工作 完成 了 ， 下 面 就 让 我 们 开始 学 习 关 于 Git 的 高 级 用 法 。 
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11.5.1 分 支 的 用 法 

分 支 是 版 本 控制 工具 中 比较 高 级 且 比 较 重要 的 一 个 概念 , 它 主 要 的 作用 就 是 在 现 有 代码 的 基 
础 上 开辟 一 个 分 又 口 ， 使 得 代码 可 以 在 主干 线 和 分 支线 上 同时 进行 开发 ， 且 相互 之 间 不 会 影响 。 
分 支 的 工作 原理 示意 图 如 图 11.25 所 示 。 


DO 


Ce 


了 〇 表示 一 次 提交 
图 11.25 分 支 的 工作 原理 示意 图 


你 也 许 会 有 疑惑 , 为 什么 需要 建立 分 支 呢 ”只 在 主干 线 上 进行 开发 不 是 挺 好 的 吗 ? 没 错 , 通 
常情 况 下 ， 只 在 主干 线 上 进行 开发 是 完全 没有 问题 的 , 不 过 一 旦 涉及 出 版 本 的 情况 ， 如 果 不 建立 
分 支 的 话 ， 你 就 会 非常 地 头疼 。 举 个 简单 的 例子 吧 ， 比 如 说 你 们 公司 研发 了 一 款 不 错 的 软件 ， 最 
近 刚 刚 完 成 ， 并 推出 了 1.0 版 本 。 但 是 领导 是 不 会 让 你 们 闲 着 的 ， 马 上 提出 了 新 的 需求 ， 让 你 们 
投入 到 了 1.1 版 本 的 开发 工作 当中 。 过 了 几 个 星期 ，1.1 版 本 的 功能 已 完成 了 一 半 , 但 是 这 个 时 候 
有 用 户 反馈 ， 之 前 上 线 的 1.0 版 本 发 现 了 几 个 重大 的 bug， 严 重 影响 软件 的 正常 使 用 。 领 导 也 相 
当 重 视 这 个 问题 ， 要 求 你 们 立刻 修复 这 些 bug， 并 重新 发 布 1.0 版 本 ， 但 这 个 时 候 你 就 非常 为 难 
了 ， 你 会 发 现 根本 没 法 去 修复 这 些 bug。 因 为 现在 1.1 版 本 已 开发 一 半 了 ， 如 果 在 现 有 代码 的 基 
础 上 修复 这 些 bug， 那 么 更 新 的 1.0 版 本 将 会 带 有 一 半 1.1 版 本 的 功能 ! 

进退 两 难 了 是 不 是 ?但 是 如 果 你 使 用 了 分 支 的 话 ， 就 完全 不 会 存在 这 个 让 人 头疼 的 问题 。 你 
只 需要 在 发 布 1.0 版 本 的 时 候 建立 一 个 分 支 ， 然 后 在 主干 线 上 继续 开发 1.1 版 本 的 功能 。 当 1.0 
版 本 上 发 现任 何 bug 的 时 候 ， 就 在 分 支线 上 进行 修改 ， 然 后 发 布 新 的 1.0 版 本 ， 并 记得 将 修改 后 
的 代码 合并 到 主干 线 上 。 这 样 的 话 ， 不 仅 可 以 轻松 解决 掉 1.0 版 本 存在 的 bug， 而 且 保 证 了 主干 
线 上 的 代码 也 已 经 修复 了 这 些 bug， 当 1.1 版 本 发 布 时 就 不 会 有 同样 的 bug 存 在 了 。 

说 了 这 么 多 ， 相 信 你 也 已 经 意识 到 分 支 的 重要 性 了 ,那么 我 们 马上 来 学 习 一 下 如 何在 Git 中 
操作 分 支 吧 。 

分 支 的 英文 名 是 branch， 如 果 想 要 查看 当前 的 版 本 库 当 中 有 哪些 分 支 ， 可 以 使 用 git branch 
这 个 命令 ， 结 果 如 图 11.26 所 示 。 


区 


图 11.26 查看 所 有 分 支 


由 于 目前 LBSTest 项 目 中 还 没有 创建 过 任何 分 支 , 因此 只 有 一 个 master 分支 存 在 , 这 也 就 是 
前 面 所 说 的 主干 线 。 接 下 来 我 们 尝试 去 创建 一 个 分 支 ， 命令 如 下 : 
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git branch version1.0 
这 样 就 创建 了 一 个 名 为 version1.0 的 分 支 , 我 们 再 次 输入 git branch 这 个 命令 来 检查 一 下 ， 
结果 如 图 11.27 所 示 。 


图 11.27 再 次 查看 所 有 分 支 


可 以 看 到 ， 果 然 有 一 个 叫 作 version1.0 的 分 支出 现 了 。 你 会 发 现 ，master 分 支 的 前 面 有 一 个 
“#” 号 ， 说 明 目 前 我 们 的 代码 还 是 在 master 分 支 上 的 ， 那么 怎样 才能 切换 到 version1.0 这 个 分 支 
上 呢 ? 其 实 也 很 简单 ， 只 需要 使 用 checkout 命令 即 可 ， 如 下 所 示 : 


git checkout version1.0 


再 次 输入 git branch 来 进行 检查 ， 结 果 如 图 11.28 所 示 。 


图 11.28 ”查看 切换 分 支 后 的 结果 


可 以 看 到 ， 我 们 已 经 把 代码 成 功 切换 到 version1.0 这 个 分 支 上 了 。 

需要 注意 的 是 ,在 version1.0 分 支 上 修改 并 提交 的 代码 将 不 会 影响 到 master 分 支 。 同 样 的 道 
理 , 在 master 分 支 上 修改 并 提交 的 代码 也 不 会 影响 到 version1.0 分 支 。 因 此 ,如 果 我 们 在 version1.0 
分 支 上 修复 了 一 个 bug, 在 master 分支 上 这 个 bug 仍然 是 存在 的 。 这 时 将 修改 的 代码 一 行 行 复制 
到 master 分 支 上 显然 不 是 一 种 聪明 的 做 法 ， 最 好 的 办 法 就 是 使 用 merge 命令 来 完成 合并 操作 ， 
如 下 所 示 


git checkout master 
git merge version1.0 


仅仅 这 样 简 单 的 两 行 命令 ， 就 可 以 把 在 version1.0 分支 上 修改 并 提交 的 内 容 合 并 到 master 分 
支 上 了 。 当 然 , 在 合并 分 支 的 时 候 还 有 可 能 出 现代 码 冲 突 的 情况 ,这 个 时 候 你 就 需要 静 下 心 来 慢 
慢 地 找 出 并 解决 这 些 冲 突 ，Git 在 这 里 就 无 法 帮助 你 了 。 

最 后 ， 当 我 们 不 再 需要 version1.0 这 个 分 支 的 时 候 ， 可 以 使 用 如 下 命令 将 这 个 分 支 删 除 掉 : 


git branch -D version1.0 


11.5.2 与 远程 版 本 库 协 作 


可 以 这 样 说 , 如 果 你 是 一 个 人 在 开发 , 那么 使 用 版 本 控制 工具 就 远 远 无 法 发 挥 出 它 真 正 强大 
的 功能 。 没 错 ， 所 有 版 本 控制 工具 最 重要 的 一 个 特点 就 是 可 以 使 用 它 来 进行 团队 合作 开发 。 每 个 
人 的 电脑 上 都 会 有 一 份 代码 ， 当 团队 的 某 个 成 员 在 自己 的 电脑 上 编写 完成 了 某 个 功能 后 , 就 将 代 
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码 提交 到 服务 器 , 其 他 的 成 员 只 需要 将 服务 器 上 的 代码 同步 到 本 地 , 就 能 保证 整个 团队 所 有 人 的 
代码 都 相同 。 这 样 的 话 ， 每 个 团队 成 员 就 可 以 各 司 其 职 ， 大 家 共同 来 完成 一 个 较为 庞大 的 项 目 。 

那么 如 何 使 用 Git 来 进行 团队 合作 开发 呢 ? 这 就 需要 有 一 个 远程 的 版 本 库 ， 团 队 的 每 个 成 员 
都 从 这 个 版 本 库 中 获取 到 最 原始 的 代码 , 然后 各 自 进 行 开发 , 并 且 以 后 每 次 提交 的 代码 都 同步 到 
远程 版 本 库 上 就 可 以 了 。 另外 , 团队 中 的 每 个 成 员 最 好 都 要 养 成 经 常 从 版 本 库 中 获取 最 新 代码 的 
习惯 ,不 然 的 话 ， 大 家 的 代码 就 很 有 可 能 经 常 出 现 冲 突 。 

比如 说 现在 有 一 个 远程 版 本 库 的 Git 地址 是 https://github.com/example/test.git, 就 可 以 使 用 如 
下 的 命令 将 代码 下 载 到 本 地 : 

git clone https://github.com/example/test.git 

之 后 你 在 这 份 代码 的 基础 上 进行 了 一 些 修改 和 提交 , 那么 怎样 才能 把 本 地 修改 的 内 容 同 步 到 
远程 版 本 库 上 呢 ? 这 就 需要 借助 push 命令 来 完成 了 ， 用 法 如 下 所 示 : 

git push origin master 

其 中 origin 部 分 指定 的 是 远程 版 本 库 的 Git 地 址 , master 部 分 指定 的 是 同步 到 哪 一 个 分 支 
上 , 上述 命 令 就 完成 了 将 本 地 代码 同步 到 https://github.com/example/test.git 这 个 版 本 库 的 master 
分 文 上 的 功能 。 

知道 了 将 本 地 的 修改 同步 到 远程 版 本 库 上 的 方法 , 接 下 来 我 们 看 一 下 如 何 将 远程 版 本 库 上 的 
修改 同步 到 本 地 。Git 提供 了 两 种 命令 来 完成 此 功能 , 分 别 是 fetch 和 puLL，fetch 的 语法 规则 
和 push 是 差不多 的 ， 如 下 所 示 : 

git fetch origin master 

执行 这 个 命令 后 , 就 会 将 远程 版 本 库 上 的 代码 同步 到 本 地 , 不 过 同步 下 来 的 代码 并 不 会 合 3 
到 任何 分 支 上 去 ， 而 是 会 存放 到 一 个 origin/master 分 支 上 ， 这 时 我 们 可 以 通过 diff 命令 来 
查看 远程 版 本 库 上 到 底 修改 了 哪些 东西 : 


git diff origin/master 


之 后 再 调用 merge 命令 将 origin/master 分 支 上 的 修改 合并 到 主 分 支 上 即 可 ， 如 下 所 示 : 

git merge origin/master 

而 pull 命令 则 是 相当 于 将 fetch 和 merge 这 两 个 命令 放 在 一 起 执行 了 , 它 可 以 从 远程 版 本 
库 上 获取 最 新 的 代码 并 且 合 并 到 本 地 ， 用 法 如 下 所 示 : 

git pull origin master 

也 许 你 现在 对 远程 版 本 库 的 使 用 还 是 感觉 比较 抽象 , 没关系 ,因为 暂时 我 们 只 是 了 解 了 一 下 
命令 的 用 法 ， 还 没 进行 实践 ， 在 第 14 章 当 中 ， 你 将 会 对 远程 版 本 库 的 用 法 有 更 深 一 层 的 认识 。 
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11.6 小结 与 点 评 


不 得 不 说 ， 本 童 中 学 到 的 知识 应 该 还 算是 蛮 有 趣 的 吧 ? 在 这 次 的 Android 特色 开发 环节 中 ， 
我 们 主要 学 习 了 基于 位 置 服务 的 工作 原理 和 用 法 ,借助 百度 提供 的 LBS SDK， 我 们 可 以 随时 确 
定 自 己 当前 位 置 的 经 纬度 ， 并 且 还 能 获取 到 具体 的 省 、 市 、 区 、 街 道 等 地 址 。 之 后 又 学 习 了 百度 
地 图 的 用 法 , 不 仅 成 功 地 将 地 图 信息 显示 了 出 来 , 还 综合 利用 了 前 面 所 学 到 的 定位 技术 实现 了 一 
个 较为 完整 的 例子 。 

除了 基于 位 置 的 服务 之 外 ， 本 章 Git 时 间 中 继续 对 Git 的 用 法 进行 了 更 深 一 步 的 探究 ， 使 得 
我 们 对 分 支 和 远程 版 本 库 的 使 用 都 有 了 一 定 层次 的 了 解 。 

那么 关于 Android 特色 开发 的 内 容 就 讲 到 这 里 , 下 一 章 中 我 们 将 会 学 习 Android 5.0 系统 中 新 
增 的 一 套 全 新 的 知识 点 


Material Design。 
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最 佳 的 UI 体验 一 Material Design 实战 


其 实 长 久 以 来 ,大 多 数 人 都 认为 Android 系统 的 UI 并 不 算 美观 ， 至少 没有 iOS 系统 的 美观 。 
以 至 于 很 多 IT 公司 在 进行 应 用 界面 设计 的 时 候 ， 为 了 保证 双 平 台 的 统一 性 ， 强 制 要 求 Android 
端的 界面 风格 必须 和 iOS 端 一 致 。 这 种 情况 在 现实 工作 当中 实在 是 太 和 常见 了 , 虽然 我 认为 这 是 非 
常 不 合理 的 ,因为 对 于 一 般 用 户 来 说 ,他 们 不 太 可 能 会 在 两 个 操作 系统 上 分 别 去 使 用 同一 个 应 用 ， 
但 是 却 必定 会 在 同一 个 操作 系统 上 使 用 不 同 的 应 用 。 因 此 , 同一 个 操作 系统 中 各 个 应 用 之 间 的 界 
面 统 一 性 要 远 比 一 个 应 用 在 双 平 台 的 界面 统一 性 重要 得 多 , 只 有 这 样 , 才能 给 使 用 者 带 来 更 好 的 
用 户 体 验 。 

但 问题 在 于 ，Android 标准 的 界面 设计 风格 并 不 是 特别 被 大 众 所 接 受 ， 很 多 公司 都 觉得 自己 
完全 可 以 设计 出 更 加 好 看 的 界面 ， 从 而 导致 Android 平 台 的 界面 风格 长 期 难以 得 到 统一 。 为 了 解 
决 这 个 问题 ， 谷 歌 也 是 祭 出 了 杀手 铜 ， 在 2014 年 Google IO 大 会 上 重 磅 推出 了 一 套 全 新 的 界面 
设计 语言 


本 章 我 们 就 将 对 Material Design 进行 一 次 深入 的 学 习 。 


Material Design。 


12.1 什么 是 Material Design 


Material Design 是 由 谷歌 的 设计 工程 师 们 基于 传统 优秀 的 设计 原则 , 结合 丰富 的 创意 和 科 
学 技术 所 发 明 的 一 套 全 新 的 界面 设计 语言 ， 包 含 了 视觉 、 运 动 、 互 动 效 果 等 特性 。 那 么 谷歌 
赁 什么 认为 Material Design 就 能 解决 Android 平台 界面 风格 不 统一 的 问题 呢 ? 一 言 以 蔽 之 ， 
好 看 ! 

没 错 ， 这 次 谷歌 在 界面 设计 上 确实 是 下 足 了 功夫 ， 很 多 媒体 评论 ，Material Design 的 出 现 使 
得 Android 首次 在 UI 方面 超越 了 iOS。 按 照 正常 的 思维 来 想 ， 如 果 各 个 公司 都 无 法 设计 出 比 
Material Design 更 出 色 的 界面 风格 , 那么 它们 就 应 该 理所当然 地 使 用 Material Design 来 设计 界面 ， 
从 而 也 就 能 解决 Android 平台 界面 风格 不 统一 的 问题 了 。 
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Mtaterial Design 实战 


为 了 做 出 表率 ， 和 谷歌 从 Android 5.0 系统 开始 ， 就 将 所 有 内 置 的 应 用 都 使 用 Material Design 
风格 来 进行 设计 。 这 里 我 随便 截 了 两 张 图 ， 你 可 以 先 欣赏 一 下 ， 如 图 12.1 所 示 。 
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图 12.1 使 用 Material Design 设计 的 应 用 


其 中 ,左边 的 应 用 是 Play Store， 右 边 的 应 用 是 YouTube。 可 以 看 出 ， 它 们 的 界面 都 十 分 美 
观 ， 而 它们 正 是 使 用 Material Design 来 进行 设计 的 。 

不 过 ， 在 重 磅 推出 之 后 ，Material Design 的 普及 程度 却 不 能 说 是 特别 理想 。 因 为 这 只 是 一 个 
推荐 的 设计 规范 ， 主 要 是 面向 UI 设计 人 员 的 ， 而 不 是 面向 开发 者 的 。 很 多 开发 者 可 能 根本 就 搞 
不 清楚 什么 样 的 界面 和 效果 才 叫 Material Design， 就 算 搞 清楚 了 ， 实 现 起 来 也 会 很 费劲 ， 因 为 不 
少 Material Design 的 效果 是 很 难 实现 的 ， 而 Android 中 却 几 乎 没有 提供 相应 的 API 支持 ,一 切 都 
要 靠 开 发 者 自己 从 零 写 起 。 

谷歌 当然 也 意识 到 了 这 个 问题 ， 于 是 在 2015 年 的 Google IO 大 会 上 推出 了 一 个 Design 
Support 库 ， 这 个 库 将 Material Design 中 最 具 代 表 性 的 一 些 控件 和 效果 进行 了 封装 ， 使 得 开发 者 
在 即使 不 了 解 Material Design 的 情况 下 也 能 非常 轻松 地 将 自己 的 应 用 Material 化 。 本 章 中 我 们 就 
将 对 Design Support 这 个 库 进行 深入 的 学 习 , 并 且 配 合 一 些 其 他 的 控件 来 完成 一 个 优秀 的 Material 
Design 应 用 。 

新 建 一 个 MaterialTest 项目， 然后 我 们 马上 开始 吧 


12.2 Toolbar 


Toolbar 将 会 是 我 们 接触 的 第 一 个 Material 控件 。 虽 说 对 于 Toolbar 你 暂时 应 该 还 是 比较 陌生 
的 ， 但 是 对 于 它 的 另 一 个 相关 控件 ActionBar， 你 就 应 该 有 点 熟悉 了 。 
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回忆 一 下 , 我 们 曾经 在 3.4.1 小 节 为 了 使 用 一 个 自 定 义 的 标题 栏 ， 而 把 系统 原生 的 ActionBar 
隐藏 掉 。 没 错 ， 每 个 活动 最 顶部 的 那个 标题 栏 其 实 就 是 ActionBar， 之 前 我 们 编写 的 所 有 程序 里 
一 直 都 有 ActionBar 的 身影 。 

不 过 ActionBar 由 于 其 设计 的 原因 , 被 限定 只 能 位 于 活动 的 项 部 , 从 而 不 能 实现 一 些 Material 
Design 的 效果 ， 因 此 官方 现在 已 经 不 再 建议 使 用 ActionBar 了 。 那 么 本 书 中 我 也 就 不 准备 再 介绍 
ActionBar 的 用 法 了， 而 是 直接 讲解 现在 更 加 推荐 使 用 的 Toolbar。 


Toolbar 的 强大 之 处 在 于 ， 它 不 仅 继承 了 ActionBar 的 所 有 功能 ， 而 且 灵 活性 很 高 ， 可 以 配合 
其 他 控件 来 完成 一 些 Material Design 的 效果 ， 下 面 我 们 就 来 具体 学 习 一 下 。 


首先 你 要 知道 ， 任 何 一 个 新 建 的 项 目 ， 默 认 都 是 会 显示 ActionBar 的 ， 这 个 想必 你 已 经 见识 
过 太 多 次 了 。 那 么 这 个 ActionBar 到 底 是 从 哪里 来 的 呢 ? 其 实 这 是 根据 项 目 中 指定 的 主题 来 显示 
的 ， 打 开 AndroidManifest.xml 文件 看 一 下 ， 如 下 所 示 : 


<application 
android:allowBackup="true" 
android:icon="@mipmap/ic launcher" 
android:label="@string/app_name" 
android:supportsRtl="true" 
android:theme="@style/AppTheme"> 


</application> 


可 以 看 到 ,这 里 使 用 android:theme 属 性 指定 了 一 个 AppTheme 的 主题 ,那么 这 个 AppTheme 
又 是 在 哪里 定义 的 呢 ? 打开 res/values/styles.xml 文件 ， 代 码 如 下 所 示 : 


<resources> 
<!-- Base application theme. --> 
<style name="AppTheme" parent="Theme.AppCompat.Light.DarkActionBar"> 
<!-- Customize your theme here. --> 


<item name="colorPrimary">@color/colorPrimary</item> 
<item name="colorPrimaryDark">@color/colorPrimaryDark</item> 
<item name="colorAccent">@color/colorAccent</item> 

</style> 


</resources> 


这 里 定义 了 一 个 叫 AppTheme 的 主题 ， 然 后 指定 它 的 parent 主题 是 Theme.AppCompat.Light. 
DarkActionBar。 这 个 DarkActionBar 是 一 个 深 色 的 ActionBar 主题 ， 我 们 之 前 所 有 的 项 目 中 自 带 
的 ActionBar 就 是 因为 指定 了 这 个 主题 才 出 现 的 。 

而 现在 我 们 准备 使 用 Toolbar 来 替代 ActionBar， 因 此 需要 指定 一 个 不 带 ActionBar 的 主题 ， 
通常 有 Theme.AppCompat.NoActionBar 和 Theme.AppCompat.Light.NoActionBar 这 两 种 主题 可 选 。 
其 中 Theme.AppCompat.NoActionBar 表示 深 色 主 题 , 它 会 将 界面 的 主体 颜色 设 成 深 色 , 陪 裤 颜 色 
设 成 淡色 。 而 Theme.AppCompat.Light.NoActionBar 表示 淡色 主题 ， 它 会 将 界面 的 主体 颜色 设 成 
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淡色 ,陪衬 颜色 设 成 深 色 。 上 有 具体 的 效果 你 可 以 自己 动手 试 一 试 , 这 里 由 于 我 们 之 前 的 程序 一 直 都 
是 以 淡色 为 主 的， 那么 我 就 选用 淡色 主题 了 ， 如 下 所 示 : 


<resources> 
<!-- Base application theme. --> 
<style name="AppTheme" parent="Theme.AppCompat.Light.NoActionBar"> 
<!-- Customize your theme here. --> 


<item name="colorPrimary">@color/colorPrimary</item> 
<item name="colorPrimaryDark">@color/colorPrimaryDark</item> 
<item name="colorAccent">@color/colorAccent</item> 

</style> 


</resources> 


然后 观察 一 下 AppTheme 中 的 属性 重 写 ， 这 里 重 写 了 colorPrimary、colorPrimaryDark 
和 colorAccent 这 3 个 属性 的 颜色 。 那 么 这 3 个 属性 分 别 代 表 着 什么 位 置 的 颜色 呢 ? 我 用 语言 
比较 难 描述 清楚 ， 还 是 通过 一 张 图 来 理解 一 下 吧 ， 如 图 12.2 所 示 。 


colorPrimary 


textColorPrimary 
colorPrimaryDark 


windowBackground 


colorAccent 
navigationBarColor 


图 12.2 各 属性 指定 颜色 的 位 置 

可 以 看 到 ， 每 个 属性 所 指定 颜色 的 位 置 直接 一 目 了 然 了 。 

除了 上 述 3 个 属性 之 外 ， 我 们 还 可 以 通过 textColorPrimary、windowBackground 和 
navigationBarColor 等 属性 来 控制 更 多 位 置 的 颜色 。 不 过 唯 独 coLorAccent 这 个 属性 比较 难 
理解 ， 它 不 只 是 用 来 指定 这 样 一 个 按钮 的 颜色 ， 而 是 更 多 表达 了 一 个 强调 的 意思 ， 比 如 一 些 控件 
的 选中 状态 也 会 使 用 colorAccent 的 颜色 。 

现在 我 们 已 经 将 ActionBar 隐藏 起 来 了 ， 那 么 接 下 来 看 一 看 如 何 使 用 Toolbar 来 蔡 代 
ActionBar。 修 改 activity_main.xml 中 的 代码 ， 如 下 所 示 : 
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<FrameLayout xmlns:android="http://schemas.android.com/apk/res/android" 
xmlns:app="http://schemas.android,.com/apk/res-auto" 
android:layout width="match parent" 
android:layout height="match parent"> 


<android,.support.v7.widget.Toolbar 
android:id="@+id/toolbar" 
android:layout width="match parent" 
android:layout height="?attr/actionBarSize" 
android:background="?attr/colorPrimary" 
android:theme="@style/ThemeOverlay.AppCompat.Dark.ActionBar" 
app:popupTheme="@style/ThemeOverlay.AppCompat.Light" /> 


</FrameLayout> 


虽然 这 段 代码 不 长 , 但 是 里 面 着 实 有 不 少 技术 点 是 需要 我 们 去 仔细 琢磨 一 下 的 。 首先 看 一 下 
第 2 行 ， 这 里 使 用 xmtns:app 指定 了 一 个 新 的 命名 空间 。 思 考 一 下 ， 正 是 由 于 每 个 布局 文件 都 
会 使 用 xmtns:android 来 指定 一 个 命名 空间 ， 因 此 我 们 才能 一 直 使 用 android:id、android: 
layout width 等 写法 ,那么 这 里 指定 了 xmLns:app， 也 就 是 说 现在 可 以 使 用 app:attribute 
这 样 的 写法 了 。 但 是 为 什么 这 里 要 指定 一 个 xmLns:app 的 命名 空间 呢 ? 这 是 由 于 Material Design 
是 在 Android 5.0 系统 中 才 出 现 的 ， 而 很 多 的 Material 属性 在 5.0 之 前 的 系统 中 并 不 存在 ， 那 么 为 
了 能 够 兼容 之 前 的 老 系统 ， 我 们 就 不 能 使 用 android:attribute 这 样 的 写法 了 ， 而 是 应 该 使 用 
app:attribute。 

接 下 来 定义 了 一 个 Toolbar 控件 , 这 个 控件 是 由 appcompat-v7 库 提 供 的 。 这 里 我 们 给 Toolbar 
指定 了 一 个 id, 将 它 的 宽度 设置 为 match_parent, 高 度 设 置 为 actionBar 的 高 度 , 背景 色 设置 为 
colorPrimary。 不 过 下 面 的 部 分 就 稍微 有 点 难 理解 了 ， 由 于 我 们 刚才 在 styles.xml 中 将 程序 的 主题 
间 定 成 了 淡色 主题 , 因此 Toolbar 现在 也 是 淡色 主题 , 而 Toolbar 上 面 的 各 种 元 素 就 会 自动 使 用 深 
色 系 ， 这 是 为 了 和 主体 颜色 区 别 开 。 但 是 这 个 效果 看 起 来 就 会 很 差 ， 之 前 使 用 ActionBar 时 文字 
都 是 白色 的 ， 现 在 变 成 黑色 的 会 很 难看 。 那 么 为 了 能 让 Toolbar 单独 使 用 深 色 主题 ， 这 里 我 们 使 
用 android:theme 属性 ,将 Toolbar 的 主题 指定 成 了 ThemeOverlay.AppCompat.Dark.ActionBar。 
但 是 这 样 指定 完了 之 后 又 会 出 现 新 的 问题 ， 如 果 Toolbar 中 有 菜单 按钮 ( 我们 在 2.2.5 小 节 中 学 
过 )， 那 么 弹出 的 菜单 项 也 会 变 成 深 色 主题 ， 这 样 就 再 次 变 得 十 分 难看 ， 于 是 这 里 使 用 了 
app:popupTheme 属性 单独 将 弹出 的 菜单 项 指定 成 了 淡色 主题 。 之 所 以 使 用 app:popupTheme， 
是 因为 popupTheme 这 个 属性 是 在 Android 5.0 系统 中 新 增 的 ， 我 们 使 用 app:popupTheme 的 话 
就 可 以 兼容 Android 5.0 以 下 的 系统 了 。 

如 果 你 觉得 上 面 的 描述 很 绕 的 话 , 可 以 自己 动手 做 一 做 试验 , 看 看 不 指定 上 述 主题 会 是 什么 
样 的 效果 ， 这 样 你 会 理解 得 更 加 深刻 。 

写 完 了 布局 ， 接 下 来 我 们 修改 MainActivity， 代 码 如 下 所 示 : 


public class MainActivity extends AppCompatActivity { 
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@Override 

protected void onCreate(Bundle savedInstanceState) { 
super.onCreate(savedInstanceState); 
setContentView(R.layout.activity main); 
Toolbar toolbar = (Toolbar) findViewById(R.id.toolbar); 
setSupportActionBar(toolbar); 


} 


这 里 关键 的 代码 只 有 两 句 ， 首 先 通过 findViewById() 得 到 Toolbar 的 实例 ， 然 后 调用 
setSupportActionBar() 方 法 并 将 Toolbar 的 实例 传人 ， 这 样 我 们 就 做 到 既 使 用 了 Toolbar， 又 
让 它 的 外 观 与 功能 都 和 ActionBar 一 致 了 。 


现在 运行 一 下 程序 ， 效 果 如 图 12.3 所 示 。 
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MaterialTest 


图 12.3 ”Toolbar 的 标准 界面 
这 个 标题 栏 我 们 再 熟悉 不 过 了 ， 虽 然 看 上 去 和 之 前 的 标题 栏 没 什么 两 样 ， 但 其 实 它 已 经 是 
Toolbar 而 不 是 ActionBar 了 。 因 此 它 现 在 也 具备 了 实现 Material Design 效果 的 能 力 ， 这 个 我 们 在 
后 面 就 会 学 到 。 
接 下 来 我 们 再 学 习 一 些 Toolbar 比较 常用 的 功能 吧 ， 比 如 修改 标题 栏 上 显示 的 文字 内 容 。 这 
段 文字 内 容 是 在 AndroidManifestxml 中 指定 的 ， 如 下 所 示 : 


<application 
android:allowBackup="true" 
android:icon="@mipmap/ic launcher" 
android:label="@string/app_name" 
android:supportsRtl="true" 
android:theme="@style/AppTheme"> 
<activity 
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android:name=" .MainActivity" 
android:LabeL="Fruits"> 
</activity> 
</application> 


这 里 给 activity 增加 了 一 个 android:tLabet 属性 ,用 于 指定 在 Toolbar 中 显示 的 文字 内 容 ， 


如 果 没 有 指定 的 话 ， 会 默认 使 用 application 中 指定 的 Labet 内 容 ， 也 就 是 我 们 的 应 用 名 称 。 


不 过 只 有 一 个 标题 的 Toolbar 看 起 来 太 单调 了 ， 我 们 还 可 以 再 添加 一 些 action 按钮 来 让 


Toolbar 更 加 丰富 一 些 ， 这 里 我 提前 准备 了 几 张 图 片 来 作为 按钮 的 图 标 ， 将 它们 放 在 了 
drawable-xxhdpi 目录 下 。 现在 右 击 res 目录 一 New 一 Directory， 创 建 一 个 menu 文件 夹 。 然 后 右 击 
menu 文件 夹 一 New 一 Menu resource file， 创 建 一 个 toolbar.xml 文件 ， 并 编写 如 下 代码 : 


<menu xmlns:android="http://schemas.android.com/apk/res/android" 
xmlns:app="http://schemas.android.com/apk/res-auto"> 
<item 
android:id="@+id/backup" 
android:icon="@drawable/ic backup" 
android:title="Backup" 
app:showAsAction="always" /> 
<item 
android:id="@+id/delete" 
android:icon="@drawable/ic delete" 
android:title="Delete" 
app:showAsAction="ifRoom" /> 
<item 
android:id="@+id/settings" 
android:icon="@drawable/ic settings" 
android:title="Settings" 
app:showAsAction="never" /> 
</menu> 


可 以 看 到 ， 我 们 通过 <item> 标 签 来 定义 action 按钮 ，android:id 用 于 指定 按钮 的 id， 


android:icon 用 于 指定 按钮 的 图 标 ，android:titte 用 于 指定 按钮 的 文字 。 


接着 使 用 app:showAsAction 来 指定 按钮 的 显示 位 置 ,之 所 以 这 里 再 次 使 用 了 app 命 名 空间 ， 


同样 是 为 了 能 够 兼容 低 版 本 的 系统 。showAsAction 主要 有 以 下 几 种 值 可 选 ，always 表示 永远 显 
示 在 Toolbar 中 , 如 果 屏 幕 空间 不 够 则 不 显示 ; ifRoom 表示 屏幕 空间 足够 的 情况 下 显示 在 Toolbar 
中 ,不够 的 话 就 显示 在 菜单 当中 ; never 则 表示 永远 显示 在 菜单 当中 。 注 意 ，Toolbar 中 的 action 
按钮 只 会 显示 图 标 ， 菜 单 中 的 action 按钮 只 会 显示 文字 。 


人 已 \，» 


接 下 来 的 做 法 就 和 2.2.5 小 节 中 的 完全 一 臻 了， 修改 MainActivity 中 的 代码 ， 如 下 所 示 : 


public class MainActivity extends AppCompatActivity { 


public boolean onCreate0ptionsMenu(Menu menu) { 
getMenuInflater().inflate(R.menu.toolbar, menu); 
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return true; 


} 


@Override 
public boolean on0ptionsItemSeLected(MenuItem item) { 
Switch (item.getItemId()) { 
case R.id.backup: 
Toast.makeText(this, "You clicked Backup", Toast.LENGTH_SHORT). 
show(); 
break; 
case R.id.delete: 
Toast.makeText(this, "You clicked Delete", Toast.LENGTH_SHORT). 
Show() ; 
break; 
case R.id.settings : 
Toast.makeText(this, "You clicked Settings", Toast.LENGTH_SHORT). 
show(); 
break; 
default: 
} 


return true; 


} 


非常 简单 ， 我 们 在 onCreate0ptionsMenu() 方 法 中 加 载 了 toolbar.xml 这 个 菜单 文件 ， 然 后 
在 on0ptionsItemSelected() 方 法 中 处 理 各 个 按钮 的 点 击 事件 。 现 在 重新 运行 一 下 程序 ， 效 果 


如 图 12.4 所 示 。 


图 12.4 带 有 action 按钮 的 Toolbar 


可 以 看 到 ，Toolbar 上 面 现在 显示 了 两 个 action 按钮 ， 这 是 因为 Backup 按钮 指定 的 显示 位 置 
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是 always，Delete 按钮 指定 的 显示 位 置 是 iiRoom， 而 现在 屏幕 空间 很 充足 , 因此 两 个 按钮 都 会 显 
示 在 Toolbar 中 。 另 外 一 个 Settings 按钮 由 于 指定 的 显示 位 置 是 never， 所 以 不 会 显示 在 Toolbar 
中 ， 点 击 一 下 最 右边 的 菜单 按钮 来 展开 菜单 项 ， 你 就 能 找到 Settings 按钮 了 。 另 外 这 些 action 按 
钮 都 是 可 以 响应 点 击 事件 的 ， 你 可 以 自己 去 试 一 试 。 

好 了 , 关于 Toolbar 的 内 容 就 先 讲 这 么 多 吧 。 当 然 Toolbar 的 功能 还 远 远 不 只 这 些 , 不 过 我 们 
显然 无 法 在 一 节 当 中 就 把 所 有 的 用 法 全 部 学 完 , 后 面 会 结合 其 他 控件 来 挖掘 Toolbar 的 更 多 功能 。 
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滑动 菜单 可 以 说 是 Material Design 中 最 常见 的 效果 之 一 了 ,在 许多 著名 的 应 用 ( 如 Gmail、 
Google+ 等 ) 中 ， 都 有 滑动 菜单 的 功能 。 虽 说 这 个 功能 看 上 去 好 像 挺 复杂 的 ， 不 过 借助 谷歌 提供 
的 各 种 工具 ， 我 们 可 以 很 轻松 地 实现 非常 炫 酷 的 滑动 菜单 效果 ， 那 么 我 们 马上 开始 吧 。 


12.3.1 DrawerLayout 


所 谓 的 滑动 菜单 就 是 将 一 些 羔 单 选项 隐藏 起 来 , 而 不 是 放置 在 主屏 幕 上 , 然后 可 以 通过 滑动 
的 方式 将 菜单 显示 出 来 。 这 种 方式 既 节 省 了 屏幕 空间 ， 又 实现 了 非常 好 的 动画 效果 ， 是 Material 
Design 中 推荐 的 做 法 。 

不 过 如 果 我 们 全 靠 自己 去 实现 上 述 功能 的 话 ， 难 度 恕 伯 就 很 大 了 。 幸 运 的 是 ,谷歌 提供 了 
个 DrawerLayout 控件， 借助 这 个 控件 ， 实 现 滑动 菜单 简单 又 方便 。 

先 来 简单 介绍 一 下 DrawerLayout 的 用 法 吧 。 首 先 它 是 一 个 布局 ， 在 布局 中 人 允许 放 人 两 个 直 
接 子 控件 , 第 一 个 子 控件 是 主屏 幕 中 显示 的 内 容 , 第 二 个 子 控件 是 滑动 菜单 中 显示 的 内 容 。 因此 ， 
我 们 就 可 以 对 activity _ main.xml 中 的 代码 做 如 下 修改 : 

<android.support.v4.widget.DrawerLayout 

xmlns:android="http://schemas.android.com/apk/res/android" 
xmlns:app="http://schemas .android.com/apk/res-auto" 
android:id="@+id/drawer_ layout" 


android:Tlayout width="match_parent" 
android:1layout height="match parent"> 


<FrameLayout 
android:layout width="match parent" 
android:layout height="match parent"> 


<android.support.v7.widget.Toolbar 
android:id="@+id/toolbar" 
android:layout width="match parent" 
android:layout height="?attr/actionBarSize" 
android:background="?attr/colorPrimary" 
android:theme="@style/ThemeOverlay.AppCompat .Dark.ActionBar" 
app:popupTheme="@style/ThemeOverlay.AppCompat.Light" /> 
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</FrameLayout> 

<TextView 
android:Tlayout width="match_parent" 
android:Tlayout_ height="match_parent" 
android:layout gravity="start" 
android: text="This is menu" 
android: textSize="30sp" 


android: 


background="#FFF" /> 


</android.support.v4.widget.DrawerLayout> 


可 以 看 到 ， 这 里 最 外 层 的 控件 使 用 了 DrawerLayout， 这 个 控件 是 由 support-v4 库 提供 的 。 


DrawerLayout 中 放置 了 两 个 直接 子 控件 ， 第 一 个 子 控件 是 FrameLayout， 用 于 作为 主屏 幕 中 显 


示 的 内 容 ， 当 然 里 面 还 有 我 们 刚刚 定义 的 Toolbar。 第 二 个 子 控件 这 里 使 用 了 一 个 TextView, 用 


于 作为 滑动 菜单 中 显示 的 内 容 ， 其 实 使 用 什么 都 可 以 ，DrawerLayout 并 没有 限制 只 能 使 用 固定 


的 控件 。 


但 是 关于 第 二 个 子 控件 有 一 点 需要 注意 ，Layout_gravity 这 个 属性 
们 需要 告诉 DrawerLayout 滑动 菜单 是 在 屏幕 的 左边 还 是 右边 , 指定 left 表示 滑动 菜单 在 左边 , 指 
定 right 表示 滑动 菜单 在 右边 。 这 里 我 指定 了 start， 表 示 会 根据 系统 语言 进行 判断 ， 如 果 系 统 语 
言 是 从 左 往 右 的 ， 比 如 英语 、 汉 语 ， 滑 动 荣 单 就 在 左边 ， 如 果 系 统 语言 是 


一 ~ 


没 错 ， 只 需要 改动 这 么 多 就 可 以 了 , 现在 重新 运行 一 下 程序 ,然后 在 


是 必须 指定 的 ， 因 为 我 


白 语 ， 滑 动 菜单 就 在 右边 。 


从 右 往 左 的 ， 比 如 阿拉 


动 ， 就 可 以 让 滑动 菜单 显示 出 来 了 ， 如 图 12.5 所 示 。 


WB 12:40 


This is menu 


12.5 “显示 滑动 菜 


异 幕 的 左 侧 边 缘 向 右 拖 
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然后 向 左 滑动 菜单 ,或 者 点 击 一 下 菜单 以 外 的 区 域 ,都 可 以 让 滑动 菜单 关闭 ， 从 而 回 到 主 界 
面 。 无 论 是 展示 还 是 隐藏 请 动 菜单 ， 都 是 有 非常 流畅 的 动画 过 渡 的 。 

可 以 看 到 , 我 们 只 是 稍微 改动 ee i 是 不 是 觉得 
动 呢 ? 不 过 现在 的 滑动 菜单 还 有 点 问题 ， 因 为 只 屏幕 的 左 侧 边 缘 进行 拖 动 时 才能 将 菜单 拖 
出 来 ， 而 很 多 用 户 可 能 根本 就 不 知道 有 这 个 功能 ， > 该 怎么 提示 他 们 呢 ? 

Material Design 建议 的 做 法 是 在 Toolbar 的 最 左边 加 入 一 个 导航 按钮 ， 点 击 了 按钮 也 会 将 滑 
动 菜单 的 内 容 展 示 出 来 。 这 样 就 相当 于 给 用 户 提 供 了 两 种 打开 滑动 羔 单 的 方式 , 防止 一 些 用 户 不 
知道 屏幕 的 左 侧 边缘 是 可 以 拖 动 的 。 

下 面 我 们 开始 来 实现 这 个 功能 。 首 先 我 准备 了 一 张 导航 按钮 的 图 标 ic_menu.png， 将 它 放 在 
了 drawable-xxhdpi 目录 下 。 然 后 修改 MainActivity 中 的 代码 ， 如 下 所 示 : 


public class MainActivity extends AppCompatActivity { 


private DrawerLayout mDrawerLayout; 


GOverride 
protected void onCreate(Bundle savedInstanceState) { 
super.onCreate(savedInstanceState); 
setContentView(R.layout.activity main); 
Toolbar toolbar = (Toolbar) findViewById(R.id.toolbar); 
setSupportActionBar(toolbar); 
mDrawerLayout = (DrawerLayout) findViewById(R.id.drawer layout); 
ActionBar actionBar = getSupportActionBar(); 
if (actionBar != null) { 
actionBar.setDisplayHomeAsUpEnabled (true); 
actionBar.setHomeAsUpIndicator(R.drawable.ic menu); 


@Override 
public boolean onOptionsItemSelected(MenuItem item) { 
Switch (item.getItemId()) { 
case android.R.id.home: 
mDrawerLayout .openDrawer (GravityCompat .START); 
break; 
default: 
} 


return true; 


} 


这 里 我 们 并 没有 改动 多 少 代 码 ， 首 先 调 用 findViewById() 方 法 得 到 了 DrawerLayout 的 实 
例 , 然后 调用 getSupportActionBar() 方 法 得 到 了 ActionBar 的 实例 , 虽然 这 个 ActionBar 的 具 
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体 实现 是 由 Toolbar 来 完成 的 。 接 着 调用 ActionBar 的 setDisplayHomeAsUpEnabled() 方 法 让 导 
航 按钮 显示 出 来 ， 又 调用 了 setHomeAsUpIndicator() 方 法 来 设置 一 个 导航 按钮 图 标 。 实 际 上 ， 
Toolbar 最 左 侧 的 这 个 按钮 就 叫 作 HomeAsUp 按钮 ， 它 默认 的 图 标 是 一 个 返回 的 箭头 ， 含 义 是 返 
回 上 一 个 活动 。 很 明显 ， 这 里 我 们 将 它 默认 的 样式 和 作用 都 进行 了 修改 。 

接 下 来 在 on0ptionsItemSelected() 方 法 中 对 HomeAsUp 按钮 的 点 击 事件 进行 处 理 ， 
HomeAsUp 按钮 的 id 永远 都 是 android.R.id.home。 然 后 调用 DrawerLayout 的 openDrawer() 
方法 将 滑动 菜单 展示 出 来 , 注意 openDrawer() 方 法 要 求 传人 一 个 Gravity 参数 , 为 了 保证 这 里 
的 行为 和 XML 中 定义 的 一 致 ， 我 们 传人 了 GravityCompat .START。 

现在 重新 运行 一 下 程序 ， 效 果 如 图 12.6 所 示 。 


= vults 


图 12.6 显示 HomeAsUp 按钮 


可 以 看 到 ， 在 Toolbar 的 最 左边 出 现 了 一 个 导航 按钮 ， 用 户 看 到 这 个 按钮 就 知道 这 肯定 是 可 
以 点 击 的 。 现 在 点 击 一 下 这 个 按钮 ， 滑 动 菜单 界面 就 会 再 次 展示 出 来 了 。 


12.3.2 _ NavigationView 


目前 我 们 已 经 成 功 实现 了 滑动 菜单 功能 , 其 中 滑动 功能 已 经 做 得 非常 好 了 , 但 是 菜单 却 还 很 
丑 , 毕竟 菜单 页 面 仅仅 使 用 了 一 个 TextView, 非常 单调 。 有 对 比 才 会 有 落差 , 我 们 看 一 下 Google+ 
的 滑动 荣 单 页 面 是 长 什么 样 的 ， 如 图 12.7 所 示 。 
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Locations 


Events 


Settings 


图 12.7 Google+ 的 滑动 菜单 页 面 


经 过 对 比 之 后 是 不 是 觉得 我 们 的 滑动 菜单 页 面 更 活 了 ? 不 过 没关系 , 优化 滑动 菜单 页 面 , 这 
就 是 我 们 本 小 节 的 全 部 目标 。 

事实 上 ,你 可 以 在 滑动 菜单 页 面 定 制 任意 的 布局 ,不 过 谷歌 给 我 们 提供 了 一 种 更 好 的 方法 一 一 
使 用 NavigationView。NavigationView 是 Design Support 库 中 提供 的 一 个 控件 ， 它 不 仅 是 严格 按 
照 Material Design 的 要 求 来 进行 设计 的 , 而 且 还 可 以 将 滑动 菜单 页 面 的 实现 变 得 非常 简单 。 接 下 
来 我 们 就 学 习 一 下 NavigationView 的 用 法 。 

首先 ， 既 然 这 个 控件 是 Design Support 库 中 提供 的 ， 那 么 我 们 就 需要 将 这 个 库 引 入 到 项 目 中 
才 行 。 打 开 app/build.gradle 文件 ， 在 dependencies 闭 包 中 添加 如 下 内 容 : 


dependencies { 
compile fileTree(dir: 'libs', include: ['*.jar']) 
compile 'com.android,.support:appcompat-v7:24.2.1" 
testCompile 'junit:junit:4.12， 
compile 'com.android.support:design:24.2.1' 
compile 'de.hdodenhof:circleimageview:2.1.0' 


} 

这 里 添加 了 两 行 依赖 关系 ， 第 一 行 就 是 Design Support 库 ， 第 二 行 是 一 个 开源 项 目 
CircleImageView , 它 可 以 用 来 轻松 实现 图 片 圆 形 化 的 功能 ,我 们 待 会 就 会 用 到 它 。CircleImageView 
的 项 目 主页 地 址 是 : https://github.com/hdodenhof/CircleImageView。 

在 开始 使 用 NavigationView 之 前 ， 我 们 还 需要 提前 准备 好 两 个 东西 : menu 和 headerLayout。 
menu 是 用 来 在 NavigationView 中 显示 具体 的 菜单 项 的 , headerLayout 则 是 用 来 在 NavigationView 
中 显示 头 部 布局 的 。 


我 们 先 来 准备 menu， 这 里 我 事先 找 了 几 张 图 片 来 作为 按钮 的 图 标 ， 并 将 它们 放 在 了 
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drawable-xxhdpi 目录 下 。 然 后 右 击 menu 文件 夹 一 New 一 Menu resource file ， 创 建 一 个 
nav_menu.xml 文件 ， 并 编写 如 下 代码 


<menu xmlns:android="http://schemas.android.com/apk/res/android"> 
<group android:checkableBehavior="single"> 

<item 
android:id="@+id/nav_call" 
android:icon="@drawable/nav_call" 
android:title="Call" /> 

<item 
android:id="@+id/nav friends" 
android:icon="@drawable/nav_ friends" 
android:title="Friends" /> 

<item 
android:id="G+id/nav location" 
android:icon="@drawable/nav location" 
android:title="Location" /> 

<item 
android:id="@+id/nav mail" 
android:icon="@drawable/nav mail" 
android:title="Mail" /> 

<item 
android:id="@+id/nav_ task" 
android:icon="@drawable/nav task" 
android:title="Tasks" /> 

</group> 
</menu> 


酒 
旺 


我 们 首先 在 <menu> 中 般 套 了 一 个 <group> 标 签 ， 然 后 将 group 的 checkableBehavior 必 
指定 为 single。group 表示 一 个 组 ，checkableBehavior 指定 为 single 表示 组 中 的 所 有 菜 
项 只 能 单 选 。 

那么 下 面 我 们 来 看 一 下 这 些 菜单 项 吧 。 这 里 一 共 定 义 了 5 个 item, 分别 使 用 android:id 属 
性 指定 荣 单项 的 id, android:icon 属性 指定 菜单 项 的 图 标 , android:title 属性 指定 菜单 项 显 
示 的 文字 。 就 是 这 么 简单 ， 现 在 我 们 已 经 把 menu 准备 好 了 。 

接 下 来 应 该 准备 headerLayout 了 , 这 是 一 个 可 以 随意 定制 的 布局 , 不 过 我 并 不 想 将 它 做 得 太 
复杂 。 这 里 简单 起 见 ， 我 们 就 在 headerLayout 中 放置 头像 、 用 户 名 、 邮 箱 地 址 这 3 项 内 容 吧 。 

说 到 头像 ， 那 我 们 还 需要 再 准备 一 张 图 片 ， 这 里 我 找 了 一 张 宠物 图 片 ， 并 把 它 放 在 了 
drawable-xxhdpi 目录 下 。 男 外 这 张 图 片 最 好 是 一 张 正方 形 图 片 ， 因 为 待 会 我 们 会 把 它 圆 形 化 。 然 
后 右 击 layout 文件 夹 一 New 一 Layout resource file， 创 建 一 个 nav_header.xml 文件 。 修 改 其 中 的 代 
码 ， 如 下 所 示 : 


<RelativeLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:layout width="match parent" 
android:layout height="180dp" 
android:padding="10dp" 
android:background="?attr/colorPrimary"> 


I 


l 


dl 
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<de.hdodenhof .circleimageview.CircleImageView 
android:id="@+id/icon image" 
android:layout width="70dp" 
android:layout height="70dp" 
android:src="@drawable/nav_ icon" 
android:layout centerInParent="true" /> 


<TextView 
android:id="@+id/mail" 
android:layout width="wrap_ content" 
android:layout height="wrap content" 
android:layout alignParentBottom="true" 
android:text="tonygreendev@gmail .com" 
android:textColor="#FFF" 
android:textSize="14sp" /> 


<TextView 
android:id="@+id/username" 
android:layout width="wrap_ content" 
android:layout height="wrap content" 
android:layout above="@id/mail" 
android:text="Tony Green" 
android:textColor="#FFF" 
android:textSize="14sp" /> 


</RelativeLayout> 


可 以 看 到 ， 布 局 文件 的 最 外 层 是 一 个 RelativeLayout， 我 们 将 它 的 宽度 设 为 match_parent， 
高 度 设 为 180dp ,这 是 一 个 NavigationView 比较 适合 的 高 度 ,然后 指定 它 的 背景 色 为 colorPrimary。 


在 RelativeLayout 中 我 们 放置 了 3 个 控件 ,CircleImageView 是 一 个 用 于 将 图 片 圆 形 化 的 控件 ， 
它 的 用 法 非常 简单 ， 基 本 和 ImageView 是 完全 一 样 的 , 这 里 给 它 指定 了 一 张 图 片 作为 头像 ， 然 后 
设置 为 居中 显示 。 另 外 两 个 TextView 分 别 用 于 显示 用 户 名 和 邮箱 地 址 ， 它 们 都 用 到 了 一 些 
RelativeLayonut 的 定位 属性 ， 相 信 肯 定 难 不 倒 你 吧 ? 


现在 menu 和 headerLayout 都 准备 好 了 ， 我 们 终于 可 以 使 用 NavigationView 了 。 修 改 
activity_main.xml 中 的 代码 ， 如 下 所 示 : 


<android.support.v4.widget.DrawerLayout 
xmlns:android="http://schemas.android.com/apk/res/android" 
xmlns:app="http://schemas.android,.com/apk/res-auto" 
android:id="@+id/drawer layout" 
android:layout width="match parent" 
android:layout height="match parent"> 


<FrameLayout 
android:layout width="match parent" 
android:layout height="match parent"> 


<android.support.v7.widget.Toolbar 
android:id="@+id/toolbar" 
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android:layout width="match parent" 
android:layout height="?attr/actionBarSize" 
android:background="?attr/colorPrimary" 


android:theme="@style/ThemeOverlay.AppCompat.Dark.ActionBar" 


app:popupTheme="@style/ThemeOverlay.AppCompat.Light" /> 
</FrameLayout> 


<android.support.design .widget.NavigationView 
android:id="@+id/nav_view" 
android:1layout width="match_ parent" 
android:layout height="match parent" 
android:layout gravity="start" 
app:menu="@menu/nav_menu" 
app:headerLayout="@layout/nav_header "/> 


</android.support.v4.widget.DrawerLayout> 


可 以 看 到 , 我 们 将 之 前 的 TextView 换 成 了 NavigationView, 这 样 滑 动 菜单 中 显示 的 内 容 也 就 
变 成 NavigationView 了 。 这 里 又 通过 app :menu 和 app:headerLayout 属性 将 我 们 刚才 准备 好 的 


menu 和 headerLayout 设置 了 进去 ， 这 样 NavigationView 就 定义 完成 了 。 


NavigationView 虽然 定义 完成 了 ， 但 是 我 们 还 要 去 处 理 菜单 项 的 点 击 事件 才 行 。 修 改 


MainActivity 中 的 代码 ， 如 下 所 示 : 
public class MainActivity extends AppCompatActivity { 
private DrawerLayout mDrawerLayout; 


@Override 

protected void onCreate(Bundle savedInstanceState) { 
super.onCreate(savedInstanceState);, 
setContentView(R.layout.activity main); 
Toolbar toolbar = (Toolbar) findViewById(R.id.toolbar); 
setSupportActionBar(toolbar); 


mDrawerLayout = (DrawerLayout) findViewById(R.id.drawer layout); 
NavigationView navView = (NavigationView) findViewById(R.id.nav view); 


ActionBar actionBar = getSupportActionBar(); 

if (actionBar != null) { 
actionBar.setDisplayHomeAsUpEnabled (true); 
actionBar.setHomeAsUpIndicator(R.drawable.ic menu); 


} 


navView.setCheckedItem(R.id.nav_call); 


navView.setNavigationItemSelectedListener (new NavigationView.OnNavigation 


ItemSelectedListener() { 

@Override 

public boolean onNavigationItemSeLected(MenuItem item) { 
mDrawerLayout .closeDrawers(); 
return true; 


}); 
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} 

代码 还 是 比较 简单 的 ， 这 里 首先 获取 到 了 NavigationView 的 实例 ， 然 后 调用 它 的 
setCheckedItem() 方 法 将 Call 菜单 项 设置 为 默认 选中 。 接 着 调用 了 setNavigationItem- 
SelLectedListener() 方 法 来 设置 一 个 菜单 项 选中 事件 的 监听 器 ， 当 用 户 点 击 了 任意 菜单 项 时 ， 
就 会 回调 到 onNavigationItemSelected() 方 法 中 。 我 们 可 以 在 这 个 方法 中 写 相 应 的 逻辑 处 理 ， 
不 过 这 里 我 并 没有 附加 任何 逻辑 ,只 是 调用 了 DrawerLayout 的 cLoseD rawers ( ) 方 法 将 滑动 菜单 
关闭 ， 这 也 是 合情合理 的 做 法 。 

现在 可 以 重新 运行 一 下 程序 了 ， 点 击 一 下 Toolbar 左 侧 的 导航 按钮 ， 效 果 如 图 12.8 所 示 。 


“3:10 


Location 


图 12.8 ”NavigationView 界面 


怎么 样 ? 这 样 的 滑动 荣 单 页 面 ， 你 无 论 如 何 也 不 能 说 它 丑 了 吧 ? Material Design 的 魅力 就 在 
这 里 , 它 真 的 是 一 种 非常 美观 的 设计 理念 ， 只 要 你 按照 它 的 各 种 规范 和 建议 来 设计 界面 ,最 终 做 
出 来 的 程序 就 是 特别 好 看 的 。 

相信 你 对 现在 做 出 来 的 效果 也 一 定 十 分 满意 吧 ? 不 过 不 要 满足 于 现状 , 后 面 我 们 会 实现 更 加 
炫 酶 的 效果 。 跟 紧 脚 步 ， 继 续 学 习 。 
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立 面 设计 是 Material Design 中 一 条 非常 重要 的 设计 思想 ， 也 就 是 说 ， 按 照 Material Design 的 
理念 , 应 用 程序 的 界面 不 仅仅 只 是 一 个 平面 ， 而 应 该 是 有 立体 效果 的 。 在 官方 给 出 的 示例 中 ,最 
简单 旦 最 具 代 表 性 的 立 面 设计 就 是 悬浮 按钮 了 , 这 种 按钮 不 属于 主 界面 平面 的 一 部 分 , 而 是 位 于 
另外 一 个 维度 的 ， 因 此 就 会 给 人 一 种 悬浮 的 感觉 。 
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本 节 中 我 们 会 对 这 个 悬浮 按钮 的 效果 进行 学 习 , 另外 还 会 学 习 一 种 可 交互 式 的 提示 工具 。 关 
于 提示 工具 ,我 们 之 前 一 直 都 是 使 用 的 Toast, 但 是 Toast 只 能 用 于 告知 用 户 某 某 事情 已 经 发 生 了 ， 
用 户 却 不 能 对 此 做 出 任何 的 响应 ， 那 么 今天 我 们 就 将 在 这 一 方面 进行 扩展 。 


12.4.1 FloatingActionButton 


FloatingActionButton 是 Design Support 库 中 提供 的 一 个 控件 ， 这 个 控件 可 以 帮助 我 们 比较 轻 
松 地 实现 悬浮 按钮 的 效果 。 其 实在 之 前 的 图 12.2 中 ,我 们 就 已 经 预览 过 悬浮 按钮 是 长 什么 样子 的 
了 ， 它 默认 会 使 用 colorAccent 来 作为 按钮 的 颜色 ， 我 们 还 可 以 通过 给 按钮 指定 一 个 图 标 来 表明 


这 个 按钮 的 作用 是 什么 。 


下 面 开始 来 具体 实现 。 首 先 仍然 需要 提前 准备 好 一 个 图 标 ， 这 里 我 放置 了 一 张 ic_done.png 
到 drawable-xxhdpi 目录 下 。 然 后 修改 activity main.xml 中 的 代码 ， 如 下 所 示 : 


<android.support.v4.widget.DrawerLayout 
xmlns:android="http://schemas.android.com/apk/res/android" 
xmlns:app="http://schemas.android.com/apk/res-auto" 
android:id="@+id/drawer layout" 
android:layout width="match parent" 
android:layout height="match parent"> 


<FrameLayout 


android:layout width="match parent" 
android:layout height="match parent"> 


<android,.support.v7.widget.Toolbar 


android 
android 
android 
android 
android 


:id="@+id/toolbar" 

:layout width="match parent" 

:layout height="?attr/actionBarSize" 
:background="?attr/colorPrimary" 
:theme="@style/ThemeOverlay.AppCompat .Dark.ActionBar" 


app:popupTheme="@style/ThemeOverlay.AppCompat .Light" /> 


<android.support.design.widget.FLoatingActionButton 


android : 
android : 
android : 
android : 
android : 
android : 


</FrameLayout> 


id="@+id/fab" 

layout_ width="wrap_content" 
layout _ height="wrap_content" 
layout gravity="bottom|end" 
layout margin="16dp" 
src="@drawable/ic done" /> 


</android. support.v4.widget.DrawerLayout> 

可 以 看 到 , 这 里 我 们 在 主屏 幕布 局 中 加 入 了 一 个 FloatingActionButton。 这 个 控件 的 用 法 并 没 
有 什么 特别 的 地 方 ，Layout width 和 layout height 属性 都 指定 成 wrap_content ， 
Layout_ gravity 属性 指定 将 这 个 控件 放置 于 屏幕 的 右 下 角 ， 其 中 end 的 工作 原理 和 之 前 的 
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start 是 一 样 的 , 即 如 果 系 统 语言 是 从 左 往 右 的 , 那么 end 就 表示 在 右边 , 如 果 系 统 语言 是 从 右 
往 左 的 ,那么 end 就 表示 在 左边 。 然 后 通过 Layout _ margin 属性 给 控件 的 四 周 留 点 边 距 ， 紧 贴 
着 屏幕 边缘 肯定 是 不 好 看 的 ， 最 后 通过 src 属性 给 FloatingActionButton 设置 了 一 个 图 标 。 

没 错 ， 就 是 这 么 简单 ， 现 在 我 们 就 可 以 来 运行 一 下 了 ， 效 果 如 图 12.9 所 示 。 


三 Fruits 


12.9 ” 坟 浮 按钮 的 效果 
一 个 漂亮 的 悬浮 按钮 就 在 屏幕 的 右 下 方 出 现 了 。 


如 果 你 仔细 观察 的 话 ， 会 发 现 这 个 芒 浮 按钮 的 下 面 还 有 一 点 阴影 。 其 实 这 很 好 理解 ， 因 为 
FloatingActionButton 是 悬浮 在 当前 界面 上 的 ， 既 然 是 悬浮 ， 那 么 就 理 所 应 当 会 有 投影 ，Design 
Support 库 连 这 种 细节 都 帮 有 我 们 考虑 到 了 。 


说 到 悬浮 ， 其 实 我 们 还 可 以 指定 FloatingActionButton 的 悬浮 高 度 ， 如 下 所 示 : 


<android,.support.design.widget.FloatingActionButton 
android:id="@+id/fab" 
android:layout width="wrap content" 
android:layout height="wrap content" 
android:layout gravity="bottom|end" 
android:layout margin="16dp" 
android:src="@drawable/ic done" 
app:elevation="8dp" /> 


这 里 使 用 app:elevation 属性 来 给 FloatingActionButton 指定 一 个 高 度 值 ， 高 度 值 越 大 ， 
投影 范围 也 越 大 ， 但 是 投影 效果 越 淡 ， 高 度 值 越 小 ， 投 影 范围 也 越 小 ， 但 是 投影 效果 越 浓 。 当 
然 这 些 效果 的 差异 其 实 都 不 怎么 明显 ,我 个 人 感觉 使 用 默认 的 FloatingActionButton 效果 就 已 经 
足够 了 。 


接 下 来 我 们 看 一 下 FloatingActionButton 是 如 何 处 理 点 击 事件 的 ， 毕 况 ， 一 个 按钮 首先 要 能 
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点 击 才 有 意义 。 修 改 MainActivity 中 的 代码 ， 如 下 所 示 : 
public class MainActivity extends AppCompatActivity { 
private DrawerLayout mDrawerLayout; 


@Override 

protected void onCreate(Bundle savedInstanceState) { 
Super.onCreate(SavedInstanceState ) ; 
setContentView(R.layout.activity main); 


FloatingActionButton fab = (FloatingActionButton) findViewById(R.id.fab); 
fab.setOnClickListener(new View.0nCLickListener() { 
@Override 
public void onClick(View v) { 
Toast .makeText (MainActivity.this, "FAB clicked", Toast.LENGTH_ 
SHORT) .show(); 


}); 


如 果 你 在 期 待 FloatingActionButton 会 有 什么 特殊 用 法 的 话 ， 那 可 能 就 要 让 你 失望 了 ， 它 和 
普通 的 Button 其 实 没什么 两 样 , 都 是 调用 set0nCLickListener() 方 法 来 注册 一 个 监听 器 ,， 当 点 
击 按钮 时 ,就 会 执行 监听 器 中 的 onCLick() 方 法 ,这 里 我 们 在 onCLick() 方 法 中 弹出 了 一 个 Toast。 


现在 重新 运行 一 下 程序 ， 并 点 击 FloatingActionButton， 效 果 如 图 12.10 所 示 。 


三 Fruits 


FAB clicked 


图 12.10 ”处理 FloatingActionButton 的 点 击 事件 


ES 
T 
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12.4.2 Snackbar 


现在 我 们 已 经 掌握 了 FloatingActionButton 的 基本 用 法 ,不 过 在 上 一 小 节 处 理 点 击 事件 的 时 
候 ， 仍然 是 使 用 Toast 来 作为 提示 工具 的 ， 本 小 节 中 我 们 就 来 学 习 一 个 Design Support 库 提 供 的 
更 加 先进 的 提示 工具 一 一 Snackbar。 


首先 要 明确 ，Snackbar 并 不 是 Toast 的 替代 品 ， 它 们 两 者 之 间 有 着 不 同 的 应 用 场景 。Toast 的 
作用 是 告诉 用 户 现 在 发 生 了 什么 事情 , 但 同时 用 户 只 能 被 动 接收 这 个 事情 ,因为 没有 什么 办 法 能 
让 用 户 进行 选择 。 而 Snackbar 则 在 这 方面 进行 了 扩展 ， 它 允许 在 提示 当中 加 入 一 个 可 交互 按钮 ， 
当 用 户 点 击 按钮 的 时 候 可 以 执行 一 些 额 外 的 逻辑 操作 。 打 个 比方 ， 如果 我 们 在 执行 删除 操作 的 时 
候 只 弹出 一 个 Toast 提示 ， 那 么 用 户 要 是 误 删 了 某 个 重要 数据 的 话 肯定 会 十 分 抓 狂 吧 ， 但 是 如 果 
我 们 增加 一 个 Undo 按钮 ， 就 相当 于 给 用 户 提 供 了 一 种 弥补 措施 ， 从 而 大 大 降低 了 事故 发 生 的 概 
率 ， 提升 了 用 户 体 验 。 

Snackbar 的 用 法 也 非常 简单 ， 它 和 Toast 是 基本 相似 的 ， 只 不 过 可 以 额外 增加 一 个 按钮 的 点 
事件 。 修 改 MainActivity 中 的 代码 ， 如 下 所 示 : 


public class MainActivity extends AppCompatActivity { 
private DrawerLayout mDrawerLayout; 


GOverride 

protected void onCreate(Bundle savedInstanceState) { 
super.onCreate(savedInstanceState); 
setContentView(R.layout.activity main); 


FloatingActionButton fab = (FLoatingActionButton) findViewById(R.id.fab); 
fab.setOnClickListener(new View.0nCLickListener() { 
@Override 
public void onClick(View view) { 
Snackbar.make(view, "Data deleted", Snackbar.LENGTH_SHORT) 
.SetAction("Undo", new View.OnClickListener() { 
@Override 
public void onClick(View v) { 
Toast.makeText (MainActivity.this, "Data restored", 
Toast .LENGTH_SHORT) .show() ; 
} 
}) 
.Show() ; 


可 以 看 到 ， 这 里 调用 了 Snackbar 的 mnake ( ) 方 法 来 创建 一 个 Snackbar 对 象 ，make ( ) 方 法 的 
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第 一 个 参数 需要 传人 一 个 View， 只 要 是 当前 界面 布局 的 任意 一 个 View 都 可 以 ，Snackbar 会 使 用 
这 个 View 来 自动 查找 最 外 层 的 布局 ， 用 于 展示 Snackbar。 第 二 个 参数 就 是 Snackbar 中 显示 的 内 
容 ， 第 三 个 参数 是 Snackbar 显示 的 时 长 。 这 些 和 Toast 都 是 类 似 的 。 


接着 这 里 又 调用 了 一 个 setAction() 方 法 来 设置 一 个 动作 ， 从 而 让 Snackbar 不 仅仅 是 一 个 
提示 ， 而 是 可 以 和 用 户 进行 交互 的 。 简 单 起 见 ， 我 们 在 动作 按钮 的 点 击 事件 里 面 弹 出 一 个 Toast 
提示 。 最 后 调用 show( ) 方 法 让 Snackbar 显示 出 来 。 


现在 重新 运行 一 下 程序 ， 并 点 击 悬 译 按钮 ， 效 果 如 网 12.11 所 示 。 


三 Fruits 


图 12.11 Snackbar 的 效果 


可 以 看 到 ，Snackbar 从 屏幕 底部 出 现 了 ， 上 面 有 我 们 所 设置 的 提示 文字 ， 还 有 一 个 Undo 按 
钮 ， 按 钮 是 可 以 点 击 的 。 过 一 段 时 间 后 Snackbar 会 自动 从 屏幕 底部 消失 。 
不 管 是 出 现 还 是 消失 ，Snackbar 都 是 带 有 动画 效果 的 ， 因 此 视觉 体验 也 会 比较 好 。 


不 过 你 有 没有 发 现 一 个 bug, 这 个 Snackbar 竟然 将 我 们 的 悬浮 按钮 给 遮挡 住 了 。 虽 说 也 不 是 
什么 重大 的 问题 ， 因 为 Snackbar 过 一 会 儿 就 会 自动 消失 ， 但 这 种 用 户 体验 总 归 是 不 友好 的 。 有 
没有 什么 办 法 能 解决 一 下 呢 ? 当然 有 ， 只 需要 借助 CoordinatorLayout 就 可 以 轻松 解决 。 


12.4.3 CoordinatorLayout 


CoordinatorLayout 可 以 说 是 一 个 加 强 版 的 FrameLayout， 这 个 布局 也 是 由 Design Support 库 
提供 的 。 它 在 普通 情况 下 的 作用 和 FrameLayout 基本 一 致 ， 不 过 既然 是 Design Support 库 中 提供 
的 布局 ， 那 么 就 必然 有 一 些 Material Design 的 魔力 了 。 


和 实 上，CoordinatorLayout 可 以 监听 其 所 有 子 控件 的 各 种 事件 ， 然 后 自动 帮助 我 们 做 出 最 为 
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合理 的 响应 。 举 个 简单 的 例子 ， 刚 才 弹 出 的 Snackbar 提示 将 悬浮 按钮 遮挡 住 了 ， 而 如 果 我 们 能 
让 CoordinatorLayout 监听 到 Snackbar 的 弹出 事件 ， 那 么 它 会 自动 将 内 部 的 FloatingActionButton 
向 上 偏 移 ， 从 而 确保 不 会 被 Snackbar 遮挡 到 。 


至 于 CoordinatorLayout 的 使 用 也 非常 简单 , 我 们 只 需要 将 原来 的 FrameLayout 替换 一 下 就 可 
以 了 。 修 改 activity_main.xml 中 的 代码 ， 如 下 所 示 : 


<android.support.v4.widget.DrawerLayout 
xmlns:android="http://schemas.android.com/apk/res/android" 
xmlns:app="http://schemas.android,.com/apk/res-auto" 
android:id="@+id/drawer layout" 
android:layout width="match parent" 
android:layout height="match parent"> 


<android.support.design.widget.CoordinatorLayout 
android:layout width="match parent" 
android:layout height="match parent"> 


<android,.support.v7.widget.Toolbar 


android: 


android 


android 


id="@+id/toolbar" 


:layout width="match parent" 
android: 


layout height="?attr/actionBarSize" 


:background="?attr/colorPrimary" 
android: 


theme="@style/ThemeOverlay.AppCompat .Dark.ActionBar" 


app:popupTheme="@style/ThemeOverlay.AppCompat .Light" /> 


<android.support.design.widget.FloatingActionButton 


android: 
android: 
android: 


android 
android 
android 


id="@+id/fab" 
layout width="wrap_ content" 
layout height="wrap content" 


:layout gravity="bottom|end" 
:layout margin="16dp" 
:src="@drawable/ic done" /> 


</android. support .design.widget.CoordinatorLayout> 


</android.support.v4.widget.DrawerLayout> 


由 于 CoordinatorLayout 本 身 就 是 一 个 加 强 版 的 FrameLayout， 因 此 这 种 替换 不 会 有 任何 的 副 
作用 。 现 在 重新 运行 一 下 程序 ， 并 点 击 悬 浮 按钮 ， 效 果 如 图 12.12 所 示 。 
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图 12.12 ”CoordinatorLayout 自动 将 悬浮 按钮 上 移 


可 以 看 到 ， 甚 浮 按钮 自动 向 上 偏 移 了 Snackbar 的 同等 高 度 ， 从 而 确保 不 会 被 遮挡 住 ， 当 
Snackbar 消失 的 时 候 ， 巧 浮 按钮 会 自动 向 下 偏 移 回 到 原来 位 置 。 

另外 悬浮 按钮 的 向 上 和 向 下 偏 移 也 是 伴随 着 动画 效果 的 ， 且 和 Snackbar 完全 同步 ， 整 体 效 
果 看 上 去 特别 赏心悦目 。 

不 过 我 们 回 过 头 来 再 思考 一 下 ,刚才 说 的 是 CoordinatorLayout 可 以 监听 其 所 有 子 控件 的 各 种 
事件 ， 但 是 Snackbar 好 像 并 不 是 CoordinatorLayout 的 子 控件 吧 ， 为 什么 它 却 可 以 被 监听 到 呢 ? 

其 实 道理 很 简单 ， 还 记得 我 们 在 Snackbar 的 make( ) 方 法 中 传人 的 第 一 个 参数 吗 ? 这 个 参数 
就 是 用 来 指定 Snackbar 是 基于 哪个 View 来 触发 的 ,刚才 我 们 传人 的 是 FloatingActionButton 本 身 ， 
而 FloatingActionButton 是 CoordinatorLayout 中 的 子 控件 ， 因 此 这 个 事件 就 理 所 应 当 能 被 监听 到 
了 。 你 可 以 自己 再 做 个 试验 ,如 果 给 Snackbar 的 make() 方 法 传人 一 个 DrawerLayout, 那 么 Snackbar 
就 会 再 次 遮挡 住 悬 浮 按 钮 ,因为 DrawerLayout 不 是 CoordinatorLayout 的 子 控件 ,CoordinatorLayonut 
也 就 无 法 监听 到 Snackbar 的 弹出 和 隐藏 事件 了 。 


本 节 的 内 容 就 到 这 里 ， 接 下 来 我 们 继续 丰富 MaterialTest 项 目 ， 加 入 卡片 式 布局 效果 。 


12.5 卡片 式 布局 


虽然 现在 MaterialTest 中 已 经 应 用 了 非常 多 的 Material Design 效果 ， 不 过 你 会 发 现 ， 界 面 上 
最 主要 的 一 块 区 域 还 处 于 空白 状态 。 这 块 区域 通 常 都 是 用 来 放置 应 用 的 主体 内 容 的 , 我 准备 使 用 
些 精美 的 水 果 图 片 来 填充 这 部 分 区 域 。 
那么 为 了 要 让 水 果 图 片 也 能 Material 化 ， 本 节 中 我 们 将 会 学 习 如 何 实现 卡片 式 布 局 的 效果 。 
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卡片 式 布局 也 是 Materials Design 中 提出 的 一 个 新 的 概念 ， 它 可 以 让 页 面 中 的 元 素 看 起 来 就 像 在 
卡片 中 一 样 ， 并 且 还 能 拥有 圆 角 和 投影 ， 下 面 我 们 就 开始 具体 学 习 一 下 。 


12.5.1 CardView 


CardView 是 用 于 实现 卡片 式 布局 效果 的 重要 控件 ,由 appcompat-v7 库 提供 。 实 际 上 ,CardView 
也 是 一 个 FrameLayout， 只 是 额外 提供 了 圆 角 和 阴影 等 效果 ， 看 上 去 会 有 立体 的 感觉 。 


我 们 先 来 看 一 下 CardView 的 基本 用 法 吧 ， 其 实 非 常 简单 ， 如 下 所 示 : 


<android.support.v7.widget.CardView 
android:layout width="match parent" 
android:layout height="wrap content" 
app:cardCornerRadius="4dp" 
app:elevation="5dp"> 
<TextView 
android:id="@+id/info text" 
android:layout width="match parent" 
android:layout height="wrap content"/> 
</android.support.v7.widget.CardView> 


这 里 定义 了 一 个 CardView 布局 , 我 们 可 以 通过 app:cardCornerRadius 属性 指定 卡片 圆 角 
的 弧度 , 数值 越 大 , 圆 角 的 弧度 也 越 大 。 男 外 还 可 以 通过 app:elevation 属性 指定 卡片 的 高 度 ， 
高 度 值 越 大 ,投影 范围 也 越 大 , 但 是 投影 效果 越 淡 ,高度 值 越 小 ,投影 范围 也 越 小 , 但 是 投影 效 
果 越 浓 ， 这 一 点 和 FloatingActionButton 是 一 致 的 。 

然后 我 们 在 CardView 布局 中 放置 了 一 个 TextView , 那么 这 个 TextView 就 会 显示 在 一 张 卡片 
当中 了 ，CardView 的 用 法 就 是 这 么 简单 。 

但 是 我 们 显然 不 可 能 在 如 此 宽阔 的 一 块 空白 区 域内 只 放置 一 张 卡片 , 为 了 能 够 充分 利用 屏幕 
的 空间 ， 这 里 我 准备 综合 运用 一 下 第 3 章 中 学 到 的 知识 ， 使 用 RecyclerView 来 填充 MaterialTest 
项 目的 主 界面 部 分 。 还 记得 之 前 实现 过 的 水 果 列 表 效果 吗 ? 这 次 我 们 将 升级 一 下 , 实现 一 个 高 配 
版 的 水 果 列 表 效果 。 

既然 是 要 实现 水 果 列 表 , 那么 首先 肯定 需要 准备 许多 张 水 果 图 片 , 这 里 我 从 网 上 挑选 了 一 些 
精美 的 水 果 图 片 ， 将 它们 复制 到 了 项 目 当中 。 

然后 由 于 我 们 还 需要 用 到 RecyclerView、CardView 这 几 个 控件 ,因此 必须 在 app/build.gradle 
文件 中 声明 这 些 库 的 依赖 才 行 : 

dependencies { 

compile fileTree(dir: 'libs', include: ['*.jar']) 
compile 'com.android,.support:appcompat-v7:24.2.1" 
testCompile 'junit:junit:4.12" 

compile 'com.android,.support:design:24.2.1" 
compile 'de.hdodenhof:circleimageview:2.1.0" 


compile 'com.android.support:recyclerview-v7:24.2.1' 
compile 'com.android.support:cardview-v7:24.2.1' 
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compile “com.github .bumptech.gLide:gLide:3.7.0' 
} 
注意 上 述 声 明 的 最 后 一 行 , 这 里 添加 了 一 个 Glide 库 的 依赖 。Glide 是 一 个 超级 强大 的 图 片 加 
载 库 ， 它 不 仅 可 以 用 于 加 载 本 地 图 片 ， 还 可 以 加 载 网 络 图 片 、GIF 图 片 、 甚 至 是 本 地 视频 。 最 重 
要 的 是 ，Glide 的 用 法 非常 简单 ， 只 需 一 行 代码 就 能 轻松 实现 复杂 的 图 片 加 载 功 能 ， 因 此 这 里 我 
们 准备 用 它 来 加 载 水 果 图 片 。Glide 的 项 目 主页 地 址 是 : https://github.com/bumptech/glide。 
接 下 来 开始 具体 的 代码 实现 ， 修 改 activity_main.xml 中 的 代码 ， 如 下 所 示 : 


<android.support.v4.widget.DrawerLayout 
xmlns:android="http://schemas.android.com/apk/res/android" 
xmlns:app="http://schemas.android.com/apk/res-auto" 
android:id="@+id/drawer layout" 
android:layout width="match parent" 
android:layout height="match parent"> 


Ld 
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<android.support.design.widget.CoordinatorLayout 
android:layout width="match parent" 
android:layout height="match parent"> 


<android,.support.v7.widget.Toolbar 
android:id="@+id/toolbar" 
android:layout width="match parent" 
android:layout height="?attr/actionBarSize" 
android:background="?attr/colorPrimary" 
android:theme="@style/ThemeOverlay.AppCompat.Dark.ActionBar" 
app:popupTheme="@style/ThemeOverlay.AppCompat.Light" /> 


<android.support.v7.widget.RecyclerView 
android:id="@+id/recycler_ view" 
android:layout width="match_parent" 
android:layout height="match parent" /> 


<android,.support.design.widget.FloatingActionButton 

android:id="@+id/fab" 
android:layout width="wrap_content " 
android:Layout height="wrap content" 
android:layout gravity="bottom|end" 
android:layout _ margin="16dp" 
android:src="@drawable/ic done" /> 

</android.support.design.widget.CoordinatorLayout> 


</android.support.v4.widget.DrawerLayout> 

这 里 我 们 在 CoordinatorLayout 中 添加 了 一 个 RecyclerView, 给 它 指定 一 个 id, 然后 将 宽度 和 
高 度 都 设置 为 match parent， 这 样 RecyclerView 也 就 占 满 了 整个 布局 的 空间 。 

接着 定义 一 个 实体 类 Fruit， 代 码 如 下 所 示 : 


public class Fruit { 
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private String name; 
private int imageld; 


public Fruit(String name, int imageId) { 
this.name = name; 
this.imageld = imageld; 

} 


public String getName() { 
return name; 


} 


public int getImageId() { 
return imageld; 


} 
} 
Fruit 类 中 只 有 两 个 字段 ，name 表示 水 果 的 名 字 ，jimageId 表示 水 果 对 应 图 片 的 资源 id。 


然后 需要 为 RecyclerView 的 子 项 指定 一 个 我 们 自 定 义 的 布局 ,在 layout 目录 下 新 建 fruit_item. 
xml， 代 码 如 下 所 示 : 


<android.support.v7.widget.CardView 
xmlns:android="http://schemas.android.com/apk/res/android" 
xmlns:app="http://schemas.android.com/apk/res-auto" 
android:layout width="match parent" 
android:layout height="wrap content" 
android:Layout margin="5dp" 
app:cardCornerRadius="4dp"> 


<LinearLayout 
android:orientation="vertical" 
android:layout width="match parent" 
android:layout height="wrap content"> 


<ImageView 
android:id="@+id/fruit image" 
android:layout width="match parent" 
android:layout height="100dp" 
android:scaleType="centerCrop" /> 


<TextView 

android:id="@+id/fruit name" 
android:layout width="wrap content" 
android:layout height="wrap content" 
android:layout gravity="center horizontal" 
android:layout margin="5dp" 
android:textSize="16sp" /> 

</LinearLayout> 


</android.support.v7.widget.CardView> 
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这 里 使 用 了 CardView 来 作为 子 项 的 最 外 层 布 局 ， 从 而 使 得 RecyclerView 中 的 每 个 元 素 都 是 
在 卡片 当中 的 。CardView 由 于 是 一 个 FrameLayout， 因 此 它 没 有 什么 方便 的 定位 方式 ， 这 里 我 们 
只 好 在 CardView 中 再 伦 套 一 个 LinearLayout， 然 后 在 LinearLayout 中 放置 具体 的 内 容 。 

内 容 倒 也 没有 什么 特殊 的 地 方 , 就 是 定义 了 一 个 ImageView 用 于 显示 水 果 的 图 片 , 又 定义 了 
一 个 TextView 用 于 显示 水 果 的 名 称 ， 并 让 TextView 在 水 平方 向 上 居中 显示 。 注 意 在 ImageView 
中 我 们 使 用 了 一 个 scaleType 属性 ， 这 个 属性 可 以 指定 图 片 的 缩放 模式 。 由 于 各 张 水 果 图 片 的 
长 宽 比 例 可 能 都 不 一 致 ， 为 了 让 所 有 的 图 片 都 能 填充 满 整个 ImageView， 这 里 使 用 了 centerCrop 
模式 ， 它 可 以 让 图 片 保持 原 有 比例 填充 满 ImageView， 并 将 超出 屏幕 的 部 分 裁剪 掉 。 

接 下 来 需要 为 RecyclerView 准备 一 个 适配器 , 新 建 FruitAdapter 类 , 让 这 个 适配器 继承 自 
RecyclerView.Adapter， 并 将 泛 型 指定 为 FruitAdapter.ViewHolder， 代 码 如 下 所 示 : 


public class FruitAdapter extends RecyclerView.Adapter<FruitAdapter.ViewHolder> { 


private Context mContext ; 
private List<Fruit> mFruitList; 


static class ViewHolder extends RecyclerView.ViewHolder { 
CardView cardView; 
ImageView fruitImage; 
TextView fruitName; 


public ViewHolder(View view) { 
super (view); 
cardView = (CardView) view; 
fruitImage = (ImageView) view.findViewById(R.id.fruit image); 
fruitName = (TextView) view.findViewById(R.id.fruit name); 


} 


public FruitAdapter(List<Fruit> fruitList) { 
mFruitList = fruitList; 
} 


@Override 
public ViewHolder onCreateViewHolder(ViewGroup parent, int viewType) { 
if (mContext == null) { 
mContext = parent.getContext(); 
站 
View view = LayoutInflater.from(mContext).inflate(R.layout,.fruit item， 
parent, false); 
return new ViewHolder (view); 


} 


@Override 

public void onBindViewHolder(ViewHolder holder, int position) { 
Fruit fruit = mFruitList,.get(position); 
holder.fruitName.setText(fruit.getName()); 
Glide.with(mContext).load(fruit.getImageId()).into(holder.fruitImage); 
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} 


@Override 
public int getItemCount() { 
return mFruitList.size(); 


} 

} 

上 述 代 码 相信 你 一 定 很 熟悉 ， 和 我 们 在 第 3 章 中 编写 的 FruitAdapter 几乎 一 模 一 样 。 唯 一 需 
要 注意 的 是 ,在 onBindViewHolder() 方 法 中 我 们 使 用 了 Glide 来 加 载 水 果 图 片 。 

那么 这 里 就 顺便 来 看 一 下 Glide 的 用 法 吧 ， 其 实 并 没有 太 多 好 讲 的 ， 因 为 Glide 的 用 法 实在 
是 太 简单 了 。 首 先 调 用 Glide .with() 方 法 并 传人 一 个 Context 、Activity 或 Fragment 参数 ， 
然后 调用 Load( ) 方 法 去 加 载 图 片 , 可 以 是 一 个 URL 地 址 ,也 可 以 是 一 个 本 地 路 径 , 或 者 是 一 个 
资源 id， 最 后 调用 into( ) 方 法 将 图 片 设置 到 具体 某 一 个 ImageView 中 就 可 以 了 。 

那么 我 们 为 什么 要 使 用 Glide 而 不 是 传统 的 设置 图 片 方式 呢 ? 因为 这 次 我 从 网 上 找 的 这 些 水 
果 图 片 像 素 都 非常 高 , 如 果 不 进 行 压缩 就 直接 展示 的 话 , 很 容易 就 会 引起 内 存 溢出 。 而 使 用 Glide 
就 完全 不 需要 担心 这 回 事 ， 因 为 Glide 在 内 部 做 了 许多 非常 复杂 的 逻辑 操作 ， 其 中 就 包括 了 图 片 
压缩 ， 我 们 只 需要 安心 按照 Glide 的 标准 用 法 去 加 载 图 片 就 可 以 了 。 

这 样 我 们 就 将 RecyclerView 的 适配器 也 准备 好 了 , 最 后 修改 MainActivity 中 的 代码 , 如 下 
所 示 : 


public class MainActivity extends AppCompatActivity { 


private DrawerLayout mDrawerLayout; 


private Fruit[] fruits = {new Fruit("Apple", R.drawable.apple), new Fruit("Banana", 
R.drawable.banana), 

new Fruit("Orange", R.drawable.orange), new Fruit("Watermelon", R. 
drawable .watermelon), 

new Fruit("Pear", R.drawable.pear), new Fruit("Grape", R.drawable. 
grape), 

new Fruit("Pineapple", R.drawable.pineapple), new Fruit("Strawberry", 
R.drawable.strawberry), 

new Fruit("Cherry", R.drawable.cherry), new Fruit("Mango", R.drawable. 
mango)}; 


private List<Fruit> fruitList = new ArrayList<>(); 

private FruitAdapter adapter; 

@Override 

protected void onCreate(Bundle savedInstanceState) { 
super.onCreate(savedInstanceState); 


setContentView(R.layout.activity main); 


initFruits(); 
RecyclerView recyclerView = (RecyclerView) findViewById(R.id.recycler view); 
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GridLayoutManager layoutManager = new GridLayoutManager(this, 2); 
recyclerView.setLayoutManager (layoutManager); 
adapter = new FruitAdapter(fruitList); 
recyclerView.setAdapter(adapter); 

} 


private void initFruits() { 
fruitList.clear(); 
for (int i1 = 0; i < 50; i++) { 
Random random = new Random(); 
int index = random.nextInt(fruits.Length) ; 
fruitList.add(fruits[index]); 


} 

在 MainActivity 中 我 们 首先 定义 了 一 个 数组 , 数组 里 面 存放 了 很 多 个 Fruit 的 实例 , 每 个 实 
例 都 代表 着 一 种 水 果 。 然 后 在 initFruits () 方 法 中 , 先是 清空 了 一 下 fruitList 中 的 数据 , 接 
着 使 用 一 个 随机 函数 ， 从 刚才 定义 的 Fruit 数组 中 随机 挑选 一 个 水 果 放 入 到 fruitList 当中 ， 
这 样 每 次 打开 程序 看 到 的 水 果 数 据 都 会 是 不 同 的 。 另 外 , 为 了 让 界面 上 的 数据 多 一 些 , 这 里 使 用 
了 一 个 循环 ， 随 机 挑选 50 个 水 果 。 

之 后 的 用 法 就 是 RecyclerView 的 标准 用 法 了 , 不 过 这 里 使 用 了 GridLayoutManager 这 种 布局 
方式 。 在 第 3 章 中 我 们 已 经 学 过 了 LinearLayoutManager 和 StaggeredGridLayoutManager， 现 在 终 
于 将 所 有 的 布局 方式 都 补 齐 了 。GridLayoutManager 的 用 法 也 没有 什么 特别 之 处 ， 它 的 构造 函数 
接收 两 个 参数 ， 第 一 个 是 Context， 第 二 个 是 列 数 ， 这 里 我 们 和 希望 每 一 行 中 会 有 两 列 数据 。 

现在 重新 运行 一 下 程序 ， 效 果 如 图 12.13 所 示 。 


图 12.13 卡片 式 布局 效果 
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可 以 看 到 , 精美 的 水 果 图 片 成 功 展示 出 来 了 。 每 个 水 果 都 是 在 一 张 单独 的 卡片 当中 的 , 并 且 
还 拥有 圆 角 和 投影 ， 是 不 是 非常 美观 ?另外 ， 由 于 我 们 是 使 用 随机 的 方式 来 获取 水 果 数 据 的 ， 
此 界面 上 会 有 一 些 重 复 的 水 果 出 现 ， 这 属于 正常 现象 。 

当 你 陶醉 于 当前 精美 的 界面 的 时 候 ， 你 是 不 是 忽略 了 一 个 细节 ?” 哎呀， 我们 的 Toolbar 怎么 
不 见 了 ! 仔细 观察 一 下 原来 是 被 RecyclerView 给 挡住 了 。 这 个 问题 又 该 怎么 解决 呢 ? 这 就 需要 借 
助 到 另外 一 个 工具 了 一 -AppBarLayout。 


12.5.2 AppBarLayout 


首先 我 们 来 分 析 一 下 为 什么 RecyclerView 会 把 Toolbar 给 遮挡 住 吧 。 其 实 并 不 难 理解 ， 由 于 
RecyclerView 和 Toolbar 都 是 放置 在 CoordinatorLayout 中 的 , 而 前 面 已 经 说 过 , CoordinatorLayout 
就 是 一 个 加 强 版 的 FrameLayout， 那 么 FrameLayout 中 的 所 有 控件 在 不 进行 明确 定位 的 情况 下 ， 
默认 都 会 摆 放 在 布局 的 左上 角 , 从 而 也 就 产生 了 遮挡 的 现象 。 其 实 这 已 经 不 是 你 第 一 次 遇 到 这 种 
情况 了 , 我 们 在 3.3.3 小 节 学 习 FrameLayout 的 时 候 就 早已 见识 过 了 控件 与 控件 之 间 遮 挡 的 效果 。 

既然 已 经 找到 了 问题 的 原因 ,那么 该 如 何 解 决 呢 ? 传统 情况 下 , 使 用 偏 移 是 唯一 的 解决 办 法 ， 
即 让 RecyclerView 向 下 偏 移 一 个 Toolbar 的 高 度 , 从 而 保证 不 会 遮挡 到 Toolbar。 不 过 我 们 使 用 的 
并 不 是 普通 的 FrameLayout， 而 是 CoordinatorLayout， 因 此 自然 会 有 一 些 更 加 巧妙 的 解决 办 法 


i i Oe nn 
实际 上 是 一 个 垂直 方向 的 LinearLayout， 它 在 内 部 做 了 很 多 滚动 事件 的 封装 ， 并 应 用 了 一 些 
Material Design 的 设计 理念 。 

那么 我 们 怎样 使 用 AppBarLayout 才能 解决 前 面 的 覆盖 问题 呢 ? 其 实 只 需要 两 步 就 可 以 了 ， 
第 一 步 将 Toolbar 舱 套 到 AppBarLayout 中 ， 第 二 步 给 RecyclerView 指定 一 个 布局 行为 。 修 改 
activity_main.xml 中 的 代码 ， 如 下 所 示 : 


<android.support.v4.widget.DrawerLayout 
xmlns:android="http://schemas.android.com/apk/res/android" 
xmlns:app="http://schemas.android,.com/apk/res-auto" 
android:id="@+id/drawer layout" 
android:layout width="match parent" 
android:layout height="match parent"> 


<android.support.design.widget.CoordinatorLayout 
android:layout width="match parent" 
android:layout height="match parent"> 


<android. support .design.widget.AppBarLayout 
android:layout width="match_parent" 
android:layout_ height="wrap_content"> 


<android.support.v7.widget.Toolbar 
android:id="@+id/toolbar" 
android:layout width="match parent" 
android:layout height="?attr/actionBarSize" 
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android:background="?attr/colorPrimary" 

android:theme="@style/ThemeOverlay.AppCompat.Dark.ActionBar" 

app:popupTheme="@style/ThemeOverlay.AppCompat.Light" /> 
</android. support.design.widget.AppBarLayout> 


<android,.support.v7.widget.RecyclerView 
android:id="@+id/recycler view" 
android:layout width="match parent" 
android:layout height="match parent" 
app:layout behavior="@string/appbar_scrolling view behavior" /> 


</android.support.design.widget.CoordinatorLayout> 


</android.support.v4.widget.DrawerLayout> 


可 以 看 到 ， 布 局 文件 并 没有 什么 太 大 的 变化 。 我 们 首先 定义 了 一 个 AppBarLayout， 并 将 
Toolbar 放置 在 了 AppBarLayout 里 面 ， 然 后 在 RecyclerView 中 使 用 app:Layout behavior 属性 
指定 了 一 个 布局 行为 。 其 中 appbar_scrolling view behavior 这 个 字符 串 也 是 由 Design 
Support 库 提 供 的 。 


现在 重新 运行 一 下 程序 ， 你 就 会 发 现 一 切 都 正常 了 ， 如 图 12.14 所 示 。 


三 Fruits 


图 12.14 解决 RecyclerView 遮挡 Toolbar 的 问题 


虽说 使 用 AppBarLayout 已 经 成 功 解决 了 RecyclerView 遮挡 Toolbar 的 问题 ,但 是 刚才 有 提 到 
过 ， 说 AppBarLayout 中 应 用 了 一 些 Material Design 的 设计 理念 ， 好 像 从 上 面 的 例子 完全 体现 不 
出 来 呀 。 事 实 上 ， 当 RecyclerView 滚动 的 时 候 就 已 经 将 滚动 事件 都 通知 给 AppBarLayout 了 ， 只 
是 我 们 还 没 进行 处 理 而 已 。 那 么 下 面 就 让 我 们 来 进一步 优化 ， 看 看 AppBarLayout 到 底 能 实现 什 
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么 样 的 Material Design 效果 。 

当 AppBarLayout 接收 到 深 动 事件 的 时 候 ， 它 内 部 的 子 控件 其 实 是 可 以 指定 如 何 去 影 响 这 些 
事件 的 ， 通 过 app:layout_scrollFlags 属性 就 能 实现 。 修 改 activity_main.xml 中 的 代码 ， 如 
下 所 示 : 


<android.support.v4.widget.DrawerLayout 
xmlns:android="http://schemas.android.com/apk/res/android" 
xmlns:app="http://schemas.android,.com/apk/res-auto" 
android:id="@+id/drawer layout" 
android:layout width="match parent" 
android:layout height="match parent"> 


<android.support.design.widget.CoordinatorLayout 
android:layout width="match parent" 
android:layout height="match parent"> 


<android.support.design.widget.AppBarLayout 
android:layout width="match parent" 
android:layout height="wrap content"> 


<android.support.v7.widget.Toolbar 

android:id="@+id/toolbar" 

android:layout width="match parent" 

android:layout height="?attr/actionBarSize" 

android:background="?attr/colorPrimary" 

android:theme="@style/ThemeOverlay.AppCompat .Dark.ActionBar" 

app:popupTheme="@style/ThemeOverlay.AppCompat .Light" 

app:layout _ scrollFlags="scroll|enterAlways|snap" /> 
</android.support.design.widget.AppBarLayout> 


</android.support,.design.widget.CoordinatorLayout> 


</android.support.v4.widget.DrawerLayout> 


这 里 在 Toolbar 中 添加 了 一 个 app:Layout_scroLLFLags 属性 , 并 将 这 个 属性 的 值 指定 成 了 
scroll|enterAlways|snap。 其 中 ，scroll 表示 当 RecyclerView 向 上 滚动 的 时 候 ，Toolbar 会 
跟着 一 起 向 上 滚动 并 实现 隐藏 ; enterALways 表示 当 RecyclerView 向 下 滚动 的 时 候 ，Toolbar 会 
跟着 一 起 向 下 滚动 并 重新 显示 。snap 表示 当 Toolbar 还 没有 完全 隐藏 或 显示 的 时 候 , 会 根据 当前 
深 动 的 距离 ， 自 动 选择 是 隐藏 还 是 显示 。 

我 们 要 改动 的 就 只 有 这 一 行 代码 而 已 ， 现 在 重新 运行 一 下 程序 ， 并 向 上 滚动 RecyclerView， 
效果 如 图 12.15 所 示 。 
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图 12.15 ”向 上 滚动 RecyclerView 隐藏 Toolbar 


可 以 看 到 , 随 着 我 们 向 上 滚动 RecyclerView, Toolbar 竟然 消失 了 , 而 向 下 滚动 RecyclerView， 
Toolbar 又 会 重新 出 现 。 这 其 实 也 是 Material Design 中 的 一 项 重要 设计 思想 ， 因 为 当 用 户 在 向 上 
滚动 RecyclerView 的 时 候 , 其 注意 力 肯定 是 在 RecyclerView 的 内 容 上 面 的 ,这 个 时 候 如 果 Toolbar 
还 占据 着 屏幕 空间 ， 就 会 在 一 定 程度 上 影响 用 户 的 阅读 体验 ， 而 将 Toolbar 隐藏 则 可 以 让 阅读 体 
验 达 到 最 佳 状态 。 当 用 户 需要 操作 Toolbar 上 的 功能 时 ， 只 需要 轻微 向 下 滚动 ，Toolbar 就 会 重新 
出 现 。 这 种 设计 方式 , 既 保 证 了 用 户 的 最 佳 阅读 效果 , 又 不 影响 任何 功能 上 的 操作 ,Material Design 
考虑 得 就 是 这 人 么 细致 人 微 。 

当然 了 ， 像 这 种 功能 ， 如 果 是 使 用 ActionBar 的 话 ， 那 就 完全 不 可 能 实现 了 ，Toolbar 的 出 现 
为 我 们 提供 了 更 多 的 可 能 。 


12.6 ”下 拉 刷 新 


下 拉 刷 新 这 种 功能 早 就 不 是 什么 新 鲜 的 东西 了 , 几乎 所 有 的 应 用 里 都 会 有 这 个 功能 。 不 过 市 
面 上 现 有 的 下 拉 刷 新 功能 在 风格 上 都 各 不 相同 ， 并 且 和 Material Design 还 有 些 格格 不 入 的 感觉 。 
因此 ， 谷 歌 为 了 让 Android 的 下 拉 刷 新 风格 能 有 一 个 统一 的 标准 ， 于 是 在 Material Design 中 制定 
了 一 个 官方 的 设计 规范 。 当 然 , 我 们 并 不 需要 去 深入 了 解 这 个 规范 到 底 是 什么 样 的 ， 因 为 谷歌 早 
就 提供 好 了 现成 的 控件 ， 我 们 只 需要 在 项 目 中 直接 使 用 就 可 以 了 。 

SwipeRefreshLayout 就 是 用 于 实现 下 拉 刷 新 功能 的 核心 类 ， 它 是 由 support-v4 库 提供 的 。 我 
们 把 想 要 实现 下 拉 刷 新 功能 的 控件 放置 到 SwipeRefreshLayout 中 , 就 可 以 迅速 让 这 个 控件 支持 下 
拉 刷 新 。 那 么 在 MaterialTest 项 目 中 ， 应 该 支持 下 拉 刷 新 功能 的 控件 自然 就 是 RecyclerView 了 。 


由 于 SwipeRefreshLayout 的 用 法 也 比较 简单 ， 下 面 我 们 就 直接 开始 使 用 了 。 修 改 activity_ 
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main.xml 中 的 代码 ， 如 下 所 示 : 


<android.support.v4.widget.DrawerLayout 
xmlns:android="http://schemas.android.com/apk/res/android" 
xmlns:app="http://schemas.android,.com/apk/res-auto" 
android:id="@+id/drawer layout" 
android:layout width="match parent" 
android:layout height="match parent"> 


<android.support.design.widget.CoordinatorLayout 
android:Layout width="match parent" 
android:layout height="match parent"> 


<android.support.v4.widget.SwipeRefreshLayout 
android:id="@+id/swipe_refresh" 
android:layout width="match parent" 
android:layout height="match_ parent" 
app:layout behavior="@string/appbar_scrolling view behavior"> 


<android.support.v7.widget.RecyclerView 
android:id="@+id/recycler view" 
android:layout width="match parent" 
android:layout height="match parent" /> 
</android. support.v4.widget.SwipeRefreshLayout> 


</android.support.design.widget.CoordinatorLayout> 


</android.support.v4.widget.DrawerLayout> 

可 以 看 到 ， 这 里 我 们 在 RecyclerView 的 外 面 义 租 套 了 一 层 SwipeRefreshLayout， 这 样 
RecyclerView 就 自动 拥有 下 拉 刷 新 功能 了 。 另外 需要 注意 , 由 于 RecyclerView 现在 变 成 了 Swipe- 
RefreshLayout 的 子 控件 ， 因 此 之 前 使 用 app:tLayout_behavior 声明 的 布局 行为 现在 也 要 移 到 
SwipeRefreshLayout 中 才 行 。 

不 过 这 还 没有 结束 , 虽然 RecyclerView 已 经 支持 下 拉 刷 新 功能 了 , 但 是 我 们 还 要 在 代码 中 处 
理 具 体 的 刷新 逻辑 才 行 。 修 改 MainActivity 中 的 代码 ， 如 下 所 示 : 


public class MainActivity extends AppCompatActivity { 


private SwipeRefreshLayout swipeRefresh; 


GOverride 

protected void onCreate(Bundle savedInstanceState) { 
super.onCreate(savedInstanceState); 
setContentView(R.layout.activity main); 
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} 


这 段 代码 应 该 i 
的 实例 ， 


设置 一 个 下 拉 刷 新 的 监听 器 , 当 触 发 了 下 拉 刷 新 操作 的 时 候 就 会 回调 这 个 


swipeRefresh = (SwipeRefreshLayout) findViewById(R.id.swipe 


swipeRefresh.setCoLorSchemeResources(R.coLor.coLorPrimary) ; 
swipeRefresh.setOnRefreshListener(new SwipeRefreshLayout. 
OnRefreshListener() { 
@Override 
public void onRefresh() { 
refreshFruits(); 
} 
}); 
} 


private void refreshFruits() { 
new Thread(new Runnable() { 
@Override 
public void run() { 
try 1{ 
Thread.sleep(2000); 
} catch (InterruptedException e) { 
e.printStackTrace(); 
} 
runOnUiThread (new Runnable() { 
@Override 
public void run() { 
initFruits(); 
adapter.notifyDataSetChanged(); 
swipeRefresh.setRefreshing(false); 


}); 


} 
}).start(); 


refresh); 


还 是 比较 好 理解 的 ， 首 先 通过 findViewById() 方 法 拿 到 SwipeRefreshLayout 


然后 调用 setCotLorSchemeResources () 方 法 来 设置 下 拉 刷 新 进度 条 的 颜色 ， 这 里 我 们 
就 使 用 主题 中 的 colorPrimary 作为 进度 条 的 颜色 了 。 接着 调用 set0nRefreshListener() 方 法 来 


方法 ， 然 后 我 们 在 这 里 去 处 理 具体 的 刷新 逻辑 就 可 以 了 。 
通常 情况 下 ,onRefresh() 方 法 中 应 该 是 去 网 络 上 请 求 最 新 的 数据 ,然后 再 将 这 些 数据 展示 


出 来 。 这 里 简 证 
本 地 刷新 操作 。refreshFruits() 方 法 中 先是 开启 了 一 个 线程 ,然后 将 线程 沉 
这 么 做 ， 
不 到 刷新 的 过 程 。 沉 图 
调用 initFruits( 


监听 器 的 onRefresh () 


起 见 ， 我 们 就 不 和 网 络 进行 交互 了 ， 而 是 调用 一 个 refreshFruits() 方 法 进行 


两 秒 钟 。 之 所 以 


是 因为 本 地 刷新 操作 速度 非常 快 ， 如果 不 将 线程 沉睡 的 话 ， 刷新 立刻 序 


结束 了 ， 从 而 看 


结束 之 后 ， 这 里 使 用 了 run0nUiThread () 方 法 将 线程 切换 回 主线 程 ， 然 后 
) 方 法 重新 生成 数据 ， 接 着 再 调用 FruitAdapter 的 notifyDataSetChanged () 


方法 通知 数据 发 生 了 变化 ， 最 后 调用 SwipeRefreshLayout 的 setRefreshing() 方 法 并 传人 


false, 


用 于 表示 刷新 事件 结束 ， 并 隐藏 刷新 进度 条 。 
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现在 可 以 重新 运行 一 下 程序 了 , 在 屏幕 的 主 界面 向 下 拖 动 ,会 有 一 个 下 拉 刷 新 的 进度 条 出 现 ， 
松手 后 就 会 自动 进行 刷新 了 ， 效 果 如 图 12.16 所 示 。 


图 12.16 “实现 下 拉 刷 新 效果 

下 拉 刷 新 的 进度 条 只 会 停留 两 秒 钟 , 之 后 就 会 自动 消失 , 界面 上 的 水 果 数 据 也 会 随 之 更 新 。 

这 样 我 们 就 把 下 拉 刷 新 的 功能 也 成 功 实 现 了 , 并 且 这 就 是 Material Design 中 规定 的 最 标准 的 

下 拉 刷 新 效果 ， 还 有 什么 会 比 这 个 更 好 看 呢 ? 目前 我 们 的 项 目 中 已 经 应 用 了 众多 Material Design 

的 效果 ，Design Support 库 中 的 常用 控件 也 学 了 大 半 了 。 不 过 本 章 的 学 习 之 旅 还 没有 结束 ， 在 最 
后 的 尾声 部 分 ， 我 们 再 来 实现 一 个 非常 震撼 的 Material Design 效果 一 一 可 折 钱 式 标 题 栏 。 


12.7 可 折 又 式 标 题 栏 


虽说 我 们 现在 的 标题 栏 是 使 用 Toolbar 来 编写 的 ， 不 过 它 看 上 去 和 传统 的 ActionBar 其 实 没 
什么 两 样 ， 只 不 过 可 以 响应 RecyclerView 的 滚动 事件 来 进行 隐藏 和 显示 。 而 Material Design 中 
并 没有 限定 标题 栏 必 须 是 长 这 个 样子 的 ， 事 实 上 ， 我 们 可 以 根据 自己 的 喜好 随意 定制 标题 栏 的 
样式 。 那么 本 节 中 我 们 就 来 实现 一 个 可 折 又 式 标 题 栏 的 效果 , 需要 借助 CollapsingToolbarLayout 
这 个 工具 。 


12.7.1 CollapsingToolbarLayout 


顾名思义 ，CollapsingToolbarLayout 是 一 个 作用 于 Toolbar 基础 之 上 的 布局 , 它 也 是 由 Design 
Support 库 提供 的 。CollapsingToolbarLayout 可 以 让 Toolbar 的 效果 变 得 更 加 丰富 ， 不 仅仅 是 展示 
一 个 标题 栏 ， 而 是 能 够 实现 非常 华丽 的 效果 。 


不 过 ，CollapsingToolbarLayout 是 不 能 独立 存在 的 ， 它 在 设计 的 时 候 就 被 限定 只 能 作为 
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AppBarLayout 的 直接 子 布局 来 使 用 。 而 AppBarLayout 又 必须 是 CoordinatorLayout 的 子 布局 ， 因 
此 本 节 中 我 们 要 实现 的 功能 其 实 需 要 综合 运用 前 面 所 学 的 各 种 知识 。 那 么 话 不 多 说 ,这 就 开始 吧 。 

首先 我 们 需要 一 个 额外 的 活动 来 作为 水 果 的 详情 展示 界面 ， 右 击 com.example.materialtest 包 
一 New 一 Activity 一 Empty Activity， 创 建 一 个 FruitActivity， 并 将 布局 名 指定 成 activity_fruit.xml， 
然后 我 们 开始 编写 水 果 详 情 展示 界面 的 布局 。 


由 于 整个 布局 文件 比较 复杂 ， 这 里 我 准备 采用 分 段 编写 的 方式 。activity_fruitxml 中 的 内 容 
主要 分 为 两 部 分 ， 一 个 是 水 果 标 题 栏 ， 一 个 是 水 果 内 容 详情 ， 我 们 来 一 步 步 实现 。 
首先 实现 标题 栏 部 分 ， 这 里 使 用 CoordinatorLayout 来 作为 最 外 层 布 局 ， 如 下 所 示 : 


<android.support.design.widget.CoordinatorLayout 
xmlns:android="http://schemas.android.com/apk/res/android" 
xmlns:app="http://schemas.android.com/apk/res-auto" 
android:layout width="match parent" 
android:layout height="match parent"> 


</android,.support.design.widget.CoordinatorLayout> 


一 开始 的 代码 还 是 比较 简单 的 ， 相 信 没 有 什么 需要 解释 的 地 方 。 注 意 始 终 记得 要 定义 一 个 
xmtns;:app 的 命名 空间 ， 在 Material Design 的 开发 中 会 经 常用 到 它 。 


接着 我 们 在 CoordinatorLayout 中 级 套 一 个 AppBarLayout， 如 下 所 示 ; 


<android.support.design.widget.CoordinatorLayout 
xmlns:android="http://schemas.android.com/apk/res/android" 
xmlns:app="http://schemas.android.com/apk/res-auto" 
android:layout width="match parent" 
android:layout height="match parent"> 


<android.support. design .widget .AppBarLayout 
android:id="@+id/appBar" 
android:Tlayout width="match_parent" 
android:layout height="250dp"> 

</android. support .design.widget.AppBarLayout> 


</android,.support.design.widget.CoordinatorLayout> 


目前 为 止 也 没有 什么 难 理解 的 地 方 ， 我 们 给 AppBarLayout 定义 了 一 个 id， 将 它 的 宽度 指定 
为 match_parent， 高 度 指定 为 230dp。 当 然 这 里 的 高 度 值 你 可 以 随意 指定 ， 不 过 我 尝试 之 后 发 
现 250dp 的 视觉 效果 比较 好 。 


接 下 来 我 们 在 AppBarLayout 中 再 人 能 套 一 个 CollapsingToolbarLayout， 如 下 所 示 : 


<android.support.design.widget.CoordinatorLayout 
xmlns:android="http://schemas.android.com/apk/res/android" 
xmlns:app="http://schemas.android.com/apk/res-auto" 
android:layout width="match parent" 
android:layout height="match parent"> 
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<android.support.design.widget.AppBarLayout 
android:id="@+id/appBar" 
android:layout width="match parent" 
android:layout height="250dp"> 


<android.support.design.widget.CollapsingToolbarLayout 


android:id="@+id/collapsing toolbar" 
android:layout width="match_parent" 
android:layout height="match_ parent" 


android:theme="@style/ThemeOverlay .AppCompat .Dark.ActionBar" 


app:contentScrim="?attr/colorPrimary" 


app:layout scrollFlags="scroll|exitUntilCollapsed"> 
</android. support.design.widget.CollapsingToolbarLayout> 


</android.support.design.widget.AppBarLayout> 


</android.support.design.widget.CoordinatorLayout> 


从 现在 开始 就 稍微 有 点 难 理解 了 , 这 里 我 们 使 用 了 新 的 布局 CollapsingToolbarLayout。 其 中 ， 


id、Layout width 和 Layout_height 这 几 个 属性 比较 简单 ， 我 就 不 解释 了 。android :theme 


属性 指定 了 一 个 ThemeOverlay.AppCompat.Dark.ActionBar 的 主题 ， 其 实 对 于 这 部 分 我 们 也 并 不 


陌生 ， 因 为 之 前 在 activity_main.xml 中 给 Toolbar 指定 的 也 是 这 个 主题 ， 只 不 过 这 里 要 实现 


更 加 高 级 的 Toolbar 效果 ， 因 此 需要 将 这 个 主题 的 指定 提 到 上 一 层 来 。 


用 于 指定 CollapsingToolbarLayout 在 趋 于 折 双 状态 以 及 折 匡 之 后 的 背景 
ToolbarLayout 在 折 车 之 后 就 是 一 个 普通 的 Toolbar， 那 么 背景 色 肯 定 应 该 是 colorPrimary 了 


app:contentScrim 


尾 
E: 


色 ， 其 实 Collapsing- 


具 


9 


体 的 效果 我 们 待 会 儿 就 能 看 到 。app:tLayout_scroLLFLags 属性 我 们 也 是 见 过 的 ， 只 不 过 之 前 


三 


成 折 和 友之 后 就 保留 在 界面 上 ， 不 再 移出 屏幕 。 


接 下 来 ,我们 在 CollapsingToolbarLayout 中 定义 标题 栏 的 具体 内 容 ， 


<android.support.design.widget.CoordinatorLayout 


如 下 所 示 : 


xmlns:android="http://schemas.android.com/apk/res/android" 


xmlns:app="http://schemas.android,.com/apk/res-auto" 
android:layout width="match parent" 
android:layout height="match parent"> 


<android.support.design.widget.AppBarLayout 
android:id="@+id/appBar" 
android:layout width="match parent" 
android:layout height="250dp"> 


<android,.support.design.widget.CollapsingToolbarLayout 


android:id="@+id/collapsing toolbar" 
android:layout width="match parent" 
android:layout height="match parent" 


android:theme="@style/ThemeOverlay.AppCompat .Dark.ActionBar" 


app:contentScrim="?attr/colorPrimary" 


app:layout scrollFlags="scroll|exitUntilCollapsed"> 


是 给 Toolbar 指定 的 ， 现 在 也 移 到 外 面 来 了 。 其 中 ，scroll 表示 CollapsingToolbarLayout 会 随 着 水 
果 内 容 详情 的 滚动 一 起 滚动 ，exitUntitCoLLapsed 表示 当 CollapsingToolbarLayout 随 着 滚动 完 
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<ImageView 
android:id="@+id/fruit image view" 
android:layout width="match_parent" 
android:layout height="match parent" 
android:scaleType="centerCrop" 
app:layout collapseMode="parallax" /> 


<android. support .v7 .widget.Toolbar 
android:id="@+id/toolbar" 
android:layout width="match_parent" 
android:layout height="?attr/actionBarSize" 
app:layout collapseMode="pin" /> 
</android.support.design.widget.CollapsingToolbarLayout> 


</android.support.design.widget.AppBarLayout> 


</android,.support.design.widget.CoordinatorLayout> 


可 以 看 到 , 我 们 在 CollapsingToolbarLayout 中 定义 了 一 个 ImageView 和 一 个 Toolbar, 也 就 意 


味 着 , 这 个 高 级 版 的 标题 栏 将 是 由 普通 的 标题 栏 加 上 图 片 组 合 而 成 的 。 这 里 定义 的 大 多 数 


们 都 是 见 过 的 ， 就 不 再 解释 了 ， 只 有 一 个 app:tlayout _collapseMode 比较 陌生 。 它 月 


i 
也 
3 


E: 


性 我 


前 控 伯 


于 指定 当 


F 在 CollapsingToolbarLayout 折 对 过程 中 的 折 车 模式 ， 其 中 Toolbar 指定 成 pin， 表 示 在 折 鞋 


的 过 程 中 位 置 始终 保持 不 变 ，ImageView 指定 成 parallax， 表 示 会 在 折 闭 的 过 程 中 产生 一 定 的 错 


位 偏 移 ， 这 种 模式 的 视觉 效果 会 非常 好 。 
这 样 我 们 就 将 水 果 标 题 栏 的 界面 编写 完成 了 ， 
activity_fruit.xml 中 的 代码 ， 如 下 所 示 : 


<android.support.design.widget.CoordinatorLayout 
xmlns:android="http://schemas.android.com/apk/res/android" 
xmlns:app="http://schemas.android.com/apk/res-auto" 
android:layout width="match parent" 
android:layout height="match parent"> 


下 面 开始 编写 水 采 


<android.support.design.widget.AppBarLayout 
android:id="@+id/appBar" 
android:layout width="match parent" 
android:layout height="250dp"> 


</android.support.design.widget.AppBarLayout> 
<android.support.v4.widget.NestedScrollView 
android:Tlayout width="match_parent" 
android:layout height="match parent" 
app:layout behavior="@string/appbar_scrolling view behavior"> 
</android.support.v4.widget.NestedScrollView> 
</android,.support.design.widget.CoordinatorLayout> 


水 果 内 容 详情 的 最 外 层 布局 使 用 了 一 个 NestedScrollView ,注意 它 和 AppBarLayout 


是 平 级 的 。 


12.7 可 折 有 合式 标题 栏 447 


我 们 之 前 在 9.2.1 小 节 学 过 ScrollView 的 用 法 ， 它 人 允许 使 用 滚动 的 方式 来 查看 屏幕 以 外 的 数据 ， 
而 NestedScrollView 在 此 基础 之 上 还 增加 了 藤 套 响应 滚动 事件 的 功能 。 由 于 CoordinatorLayout 本 
身 已 经 可 以 响应 滚动 事件 了 ， 因 此 我 们 在 它 的 内 部 就 需要 使 用 NestedScrollView 或 RecyclerView 
这 样 的 布局 。 另 外 ， 这 里 还 通过 app:Layout_behavior 属性 指定 了 一 个 布局 行为 ， 这 和 之 前 在 
RecyclerView 中 的 用 法 是 一 模 一 样 的 。 

不 管 是 ScrollView 还 是 NestedScrollView, 它们 的 内 部 都 只 允许 存在 一 个 直接 子 布 局 。 因此， 
如 果 我 们 想 要 在 里 面 放 入 很 多 东西 的 话 ， 通 常 都 会 先 舱 套 一 个 LinearLayout ， 然 后 再 在 
LinearLayout 中 放 人 具体 的 内 容 就 可 以 了 ， 如 下 所 示 : 


<android.support.design.widget.CoordinatorLayout 
xmlns:android="http://schemas.android.com/apk/res/android" 
xmlns:app="http://schemas.android,.com/apk/res-auto" 
android:layout width="match parent" 
android:layout height="match parent"> 


<android.support.v4.widget.NestedScrollView 
android:layout width="match parent" 
android:layout height="match parent" 
app: layout behavior="@string/appbar scrolling view behavior"> 


<LinearLayout 
android:orientation="vertical" 
android:layout width="match_parent" 
android:layout_ height="wrap_content"> 
</LinearLayout> 


</android.support.v4.widget.NestedScrollView> 


</android.support.design.widget.CoordinatorLayout> 


这 里 我 们 向 套 了 一 个 垂直 方向 的 LinearLayout, 并 将 Layout_width 设置 为 match_parent， 
将 Layout_height 设置 为 wrap_content。 


接 下 来 在 LinearLayout 中 放 入 具体 的 内 容 ， 这 里 我 准备 使 用 一 个 TextView 来 显示 水 果 的 内 
容 详情 ， 并 将 TextView 放 在 一 个 卡片 式 布局 当中 ， 如 下 所 示 : 


<android.support.design.widget.CoordinatorLayout 
xmlns:android="http://schemas.android.com/apk/res/android" 
xmlns:app="http://schemas.android.com/apk/res-auto" 
android:layout width="match parent" 
android:layout height="match parent"> 


<android.support.v4.widget.NestedScrollView 
android:layout width="match parent" 
android:layout height="match parent" 
app: layout behavior="@string/appbar _ scrolling view behavior"> 
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<LinearLayout 


android:layout width="match parent" 
android:layout height="match parent" 


android:orientation="vertical"> 


<android. support.v7 .widget.CardView 
android:Tlayout width="match_parent" 
android:layout _ height="wrap_content" 
android:layout marginBottom="15dp" 
android:layout marginLeft="15dp" 
android:layout marginRight="15dp" 
android:layout marginTop="35dp" 


app:cardCornerRadius="4dp"> 


<TextView 


android:id="@+id/fruit content text" 
android:Tlayout width="wrap_content" 
android:layout height="wrap_content" 
android:layout margin="10dp" /> 
</android.support.v7.widget.CardView> 


</LinearLayout> 


</android.support.v4.widget.NestedScrollView> 


</android,.support.design.widget.CoordinatorLayout> 


这 上段 代码 也 没有 什么 难 理解 的 地 方 ， 都 是 我 们 学 过 的 知识 。 需 要 注意 的 是 , 这 里 为 了 让 界面 


更 加 美观 ,我 在 CardView 和 TextView 上 都 加 了 一 些 边 里 
的 边 距 ， 这 是 为 下 面 要 编写 的 东西 留 出 空间 。 


E. 其 中 ,CardView 的 marginTop 加 了 35dp 


好 的 , 这 样 就 把 水 果 标 题 栏 和 水 果 内 容 详 情 的 界面 


都 编写 完了 , 不 过 我 们 还 可 以 在 界面 上 再 


添加 一 个 悬 译 按钮 。 这 个 悬浮 按钮 并 不 是 必需 的 , 根据 具体 的 需求 添加 就 可 以 了 , 如 果 加 入 的 话 ， 


我 们 将 免费 获得 一 些 额外 的 动画 效果 。 


为 了 做 出 示范 ， 我 就 准备 在 activity_fruit.xml 中 加 入 一 个 基 浮 按钮 了 。 这 个 界面 是 一 个 水 果 


详情 展示 界面 ， 那 么 我 就 加 入 一 个 表示 评论 作用 的 悬浮 按钮 吧 。 首 先 需 要 提前 准备 好 一 个 图 标 ， 
这 里 我 放置 了 一 张 ic_comment.png 到 drawable-xxhdpi 目录 下 。 然后 修改 activity_fruit.xml 中 的 代 


码 ， 如 下 所 示 : 


<android.support.design.widget.CoordinatorLayout 
xmlns:android="http://schemas.android.com/apk/res/android" 
xmlns:app="http://schemas.android.com/apk/res-auto" 


android:layout width="match parent" 
android:layout height="match parent"> 


<android.support.design.widget.AppBarLayout 


android:id="@+id/appBar" 
android:layout width="match parent" 
android:layout height="250dp"> 


</android.support.design.widget.AppBarLayout> 
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<android.support.v4.widget.NestedScrollView 
android:layout width="match parent" 
android:layout height="match parent" 
app: layout behavior="@string/appbar_ scrolling view behavior"> 


</android.support.v4.widget.NestedScrollView> 


<android.support.design.widget.FloatingActionButton 
android:layout _ width="wrap_content" 
android:layout height="wrap_content" 
android:layout margin="16dp" 
android:src="@drawable/ic comment" 
app:layout_anchor="@id/appBar" 
app:layout_ anchorGravity="bottom|end" /> 


</android.support.design.widget.CoordinatorLayout> 


可 以 看 到 , 这 里 加 入 了 一 个 FloatingActionButton, 它 和 AppBarLayout 以 及 NestedScrollView 
是 平 级 的 。FloatingActionButton 中 使 用 app:Layout_anchor 属性 指定 了 一 个 锚 点 ， 我 们 将 销 点 
设置 为 AppBarLayout, 这 样 悬 浮 按钮 就 会 出 现在 水 果 标 题 栏 的 区 域内 , 接着 又 使 用 app:Layout 
anchorGravity 属性 将 悬浮 按钮 定位 在 标题 栏 区 域 的 右 下 角 。 其 他 一 些 属性 都 比较 简单 ， 就 不 
再 进行 解释 了 。 

好 了 ， 现 在 我 们 终于 将 整个 activity_fruitxml 布局 都 编写 完了 ， 内 容 虽 然 比较 长 ,但 由 于 是 
分 段 编写 的 ， 并 且 每 一 步 我 都 进行 了 详细 的 说 明 ， 相 信 你 应 该 看 得 很 明白 吧 。 
界面 完成 了 之 后 ， 接 下 来 我 们 开始 编写 功能 逻辑 ， 修 改 FruitActivity 中 的 代码 ， 如 下 所 示 : 


public class FruitActivity extends AppCompatActivity { 


public static final String FRUIT NAME = "fruit name"; 
public static final String FRUIT IMAGE ID = "fruit image id"; 


GOverride 
protected void onCreate(Bundle savedInstanceState) { 
super.onCreate(savedInstanceState); 
setContentView(R.layout.activity fruit); 
Intent intent = getIntent(); 
String fruitName = intent.getStringExtra(FRUIT NAME); 
int fruitImageId = intent.getIntExtra(FRUIT IMAGE ID, 0); 
Toolbar toolbar = (Toolbar) findViewById(R.id.toolbar); 
CollapsingToolbarLayout collapsingToolbar = (CollapsingToolbarLayout) 
findViewById(R.id.collapsing toolbar); 
ImageView fruitImageView = (ImageView) findViewById(R.id.fruit image view); 
TextView fruitContentText = (TextView) findViewById(R.id.fruit content_ 
text); 
setSupportActionBar(toolbar); 
ActionBar actionBar = getSupportActionBar(); 
if (actionBar != null) { 
actionBar.setDisplayHomeAsUpEnabled(true); 
} 
collapsingToolbar.setTitle(fruitName); 
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GLide,.with(this),Load(fruitImageId) .into(fruitImageView) ; 
String fruitContent = generateFruitContent (fruitName ) ; 
fruitContentText .setText(fruitContent ) ; 

} 


private String generateFruitContent(String fruitName) { 
StringBuilder fruitContent = new StringBuilder(); 
for (int i = 0; i < 500; i++) { 
fruitContent.append(fruitName); 


return fruitContent.toString(); 


} 


@Override 
public boolean onOptionsItemSelected(MenuItem item) { 
Switch (item.getItemId()) { 
case android.R.id.home: 
finish(); 
return true,; 


} 
return super.onOptionsItemSelected(item); 


} 

FruitActivity 中 的 代码 并 不 是 很 复杂 。 首先 , 在 onCreate() 方 法 中 ,我 们 通过 Intent 获取 到 
传人 的 水 果 名 和 水 果 图 片 的 资源 id, 然后 通过 findViewById() 方 法 拿 到 刚才 在 布局 文件 中 定义 
的 各 个 控件 的 实例 。 接 着 就 是 使 用 了 Toolbar 的 标准 用 法 ， 将 它 作 为 ActionBar 显示 ， 并 启用 
HomeAsUp 按钮 。 由 于 HomeAsUp 按钮 的 默认 图 标 就 是 一 个 返回 箭头 ， 这 正 是 我 们 所 期 望 的 ， 
因此 就 不 用 再 额外 设置 别 的 图 标 了 。 

接 下 来 开始 填充 界面 上 的 内 容 ， 调 用 CollapsingToolbarLayout 的 setTitle() 方 法 将 水 果 名 
设置 成 当前 界面 的 标题 ， 然 后 使 用 Glide 加 载 传人 的 水 果 图 片 ， 并 设置 到 标题 栏 的 ImageView 上 
面 。 接 着 需要 填充 水 果 的 内 容 详情 ， 由 于 这 只 是 一 个 示例 程序 ， 并 不 需要 什么 真实 的 数据 ， 所 以 
我 使 用 了 一 个 generateFruitContent () 方 法 将 水 果 名 循环 拼接 500 次 ,从 而 生成 了 一 个 比较 长 
的 字符 串 ， 将 它 设置 到 了 TextView 上 面 。 

最 后 , 我 们 在 on0ptionsItemSelected() 方 法 中 处 理 了 HomeAsUp 按钮 的 点 击 事件 ， 当 点 
击 了 这 个 按钮 时 ， 就 调用 finish() 方 法 关闭 当前 的 活动 ， 从 而 返回 上 一 个 活动 。 

所 有 工作 都 完成 了 吗 ? 其 实 还 差 最 关键 的 一 步 , 就 是 处 理 RecyclerView 的 点 击 事件 , 不 然 的 
话 我 们 根本 就 无 法 打开 FruitActivity。 修 改 FruitAdapter 中 的 代码 ， 如 下 所 示 : 


public class FruitAdapter extends RecyclerView.Adapter<FruitAdapter.ViewHolder> { 


@Override 
public ViewHolder onCreateViewHolder(ViewGroup parent, int viewType) { 
if (mContext == null) { 
mContext = parent.getContext(); 
} 
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View view = LayoutInflater.from(mContext).inflate(R.layout.fruit item, 


parent, false); 
final ViewHolder holder = new ViewHolder (view); 


holder.cardView.setOnClickListener(new View.0nCLickListener() { 


@Override 

public void onClick(View v) { 
int position = holder.getAdapterPosition(); 
Fruit fruit = mFruitList.get(position); 


Intent intent = new Intent(mContext, FruitActivity.class); 
intent.putExtra(FruitActivity .FRUIT NAME, fruit.getName()); 
intent.putExtra(FruitActivity .FRUIT IMAGE ID, fruit.getImagelId()); 


mContext. startActivity (intent); 
} 
}); 


return holder; 


} 


最 关键 的 一 步 其 实 也 是 最 简单 的 ， 这 里 我 们 给 CardView 注册 了 一 个 点 击 事件 监听 器 ， 然 后 
在 点 击 事件 中 获取 当前 点 击 项 的 水 果 名 和 水 果 图 片 资源 这 ， 把 它们 传人 到 Intent 中 ， 最 后 调用 


startActivity() 方 法 启动 FruitActivity。 


见证 奇迹 的 时 刻 到 了 ， 现 在 重新 运行 一 下 程序 ,并 点 击 界面 上 的 任意 一 个 水 遇 
了 葡萄 ， 效 果 如 图 12.17 所 示 。 


图 12.17 水 果 的 详情 展示 界面 


， 比 如 我 点 击 


你 没有 看 错 ， 如 此 精美 的 界面 就 是 我 们 亲手 斋 出 来 的 。 这 个 界面 上 的 内 容 分 为 三 部 分 ,水果 
标题 栏 、 水 果 内 容 详情 和 悬浮 按钮 ， 相 信 你 一 眼 就 能 将 它们 区 分 出 来 吧 。Toolbar 和 水 果 背 景 图 
完美 地 融合 到 了 一 起 ， 既 保证 了 图 片 的 展示 空间 ， 又 不 影响 Toolbar 的 任何 功能 ， 那 个 向 左 的 箭 
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头 就 是 用 来 返回 上 一 个 活动 的 。 


不 过 这 并 不 是 全 部 , 真正 的 好 戏 还 在 后 头 。 我们 尝试 向 上 拖 动 水 果 内 容 详 情 ,你 会 发 现 水 果 
背景 图 上 的 标题 会 慢 慢 缩小 ， 并 且 背 景 图 会 产生 一 些 错 位 偏 移 的 效果 ， 如 图 12. 18 所 示 。 


图 12.18 向 上 拖 动 水 果 内 容 详情 


这 是 由 于 用 户 想 要 查看 水 果 的 内 容 详情 ， 此 时 界面 的 重点 在 具体 的 内 容 上 面 ,因此 标题 栏 就 
会 自动 进行 折 徐 ， 从 而 节省 屏幕 空间 。 


继续 向 上 拖 动 ， 直 到 标题 栏 变 成 完全 折 番 状态， 效果 如 图 12.19 所 示 。 


3 B 9:09 
€ Grape 


图 12.19 ”标题 栏 变 成 完全 折 赫 状态 
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可 以 看 到 , 标题 栏 的 背景 图 片 不 见 了 ,， 惹 浮 按钮 也 自动 消失 了 , 现在 水 果 标 题 栏 变 成 了 一 个 


最 普通 的 Toolbar。 这 是 由 于 用 户 正 在 阅读 具体 的 内 容 , 我 们 需要 给 他 们 提供 最 充分 的 阅读 空间 。 
而 如 果 这 个 时 候 向 下 拖 动 水 果 内 容 详情 , 就 会 执行 一 个 完全 相反 的 动画 过 程 , 最 终 恢复 成 图 12.17 


的 界面 效果 。 


不 知道 你 有 没有 被 这 个 效果 所 感动 呢 ? 在 这 里 ， 我 真心 地 感谢 Material Design 送 给 我 们 的 


礼物 。 
12.7.2 ”充分 利用 系统 状态 栏 空间 


虽说 现在 水 果 详 情 展示 界面 的 效果 已 经 非常 华丽 了 ， 但 这 并 不 代表 我 们 不 能 再 进一步 地 提 
升 。 观 察 一 下 图 12.17， 你 会 发 现 水 果 的 背景 图 片 和 系统 的 状态 栏 总 有 一 些 不 搭 的 感觉 ， 如 果 我 
们 能 将 背景 图 和 状态 栏 融 合 到 一 起 ， 那 这 个 视觉 体验 绝对 能 提升 好 几 个 档次 。 


A 


景 图 和 状态 栏 融 合 的 模式 ， 在 之 前 的 系统 中 使 用 普通 的 模式 。 


只 不 过 很 可 惜 的 是 ， 在 Android 5.0 系统 之 前 ， 我 们 是 无 法 对 状态 栏 的 背景 或 
的 ， 那 个 时 候 也 还 没有 Material Design 的 概念 。 但 是 Android 5.0 及 之 后 的 系统 都 是 支持 这 个 功 
能 的 ， 因 此 这 里 我 们 就 来 实现 一 个 系统 差异 型 的 效果 ,在 Android 5.0 及 之 后 的 系统 中 ， 使 用 背 


颜色 进行 操作 


想 要 让 背景 图 能 够 和 系统 状态 栏 融 合 , 需要 借助 android:fitsSystemWindows 这 个 属性 来 
实现 。 在 CoordinatorLayout、AppBarLayout、CollapsingToolbarLayout 这 种 能 套 结 
将 控件 的 android:fitsSystemWindows 属性 指定 成 true， 就 表示 该 控件 会 出 现在 系统 状态 栏 
里 。 对 应 到 我 们 的 程序 ， 那 就 是 水 果 标 题 栏 中 的 ImageView 应 该 设置 这 个 属性 了 。 不 过 只 给 
ImageView 设置 这 个 属性 是 没有 用 的 , 我 们 必须 将 ImageView 布局 结构 中 的 所 有 父 布局 都 设置 上 


这 个 属性 才 可 以 ， 修 改 activity_fruitxml 中 的 代码 ， 如 下 所 示 : 


<android.support.design.widget.CoordinatorLayout 


xmlns:android="http://schemas.android.com/apk/res/android" 


xmlns:app="http://schemas.android,.com/apk/res-auto" 
android:layout width="match parent" 

android:layout height="match parent" 
android:fitsSystemWindows="true"> 


<android.support.design.widget.AppBarLayout 
android:id="@+id/appBar" 
android:layout width="match parent" 
android:layout height="250dp" 
android:fitsSystemWindows="true"> 


<android.support.design.widget.CollapsingToolbarLayout 


android:id="@+id/collapsing toolbar" 
android:layout width="match parent" 
android:layout height="match parent" 


构 的 布局 中 ， 


android:theme="@style/ThemeOverlay.AppCompat .Dark.ActionBar" 


android:fitsSystemWindows="true" 
app:contentScrim="?attr/colorPrimary" 
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app:Layout scrollFlags="scroll|exitUntilCollapsed"> 


<ImageView 
android:id="@+id/fruit image view" 
android:layout width="match parent" 
android:layout height="match parent" 
android:scaleType="centerCrop" 
android:fitsSystemWindows="true" 
app:layout collapseMode="parallax" /> 


</android.support.design.widget.CollapsingToolbarLayout> 


</android.support.design.widget.AppBarLayout> 


</android,.support.design.widget.CoordinatorLayout> 


但 是 , 即使 我 们 将 android:fitsSystemWindows 属性 都 设置 好 了 还 是 没有 用 的 , 因为 还 必 
须 在 程序 的 主题 中 将 状态 栏 颜色 指定 成 透明 色 才 行 。 指 定 成 透明 色 的 方法 很 简单 ， 在 主题 中 将 
android:statusBarColor 属性 的 值 指定 成 Gandroid:color/transparent 就 可 以 了 。 但 问题 
在 于 ，android:statusBarColor 这 个 属性 是 从 API 21， 也 就 是 Android 5.0 系统 开始 才 有 的 ， 
之 前 的 系统 无 法 指定 这 个 属性 。 那 么 ， 系 统 差异 型 的 功能 实现 就 要 从 这 里 开始 了 。 

右 击 res 目录 一 New 一 Directory， 创 建 一 个 values-v21 目录 , 然后 右 击 values-v21 目录 一 New 
一 Values resource file， 创 建 一 个 styles.xml 文件 。 接 着 对 这 个 文件 进行 编写 ， 代 码 如 下 所 示 : 


<resources> 


<style name="FruitActivityTheme" parent="AppTheme"> 
<item name="android:statusBarColor">@android:color/transparent</item> 
</style> 


</resources> 


这 里 我 们 定义 了 一 个 FruitActivityTheme 主题 , 它 是 专门 给 FruitActivity 使 用 的 。FruitActivity- 
Theme 的 parent 主题 是 AppTheme， 也 就 是 说 ， 它 继承 了 AppTheme 中 的 所 有 特性 。 然 后 我 们 在 
FruitActivityTheme 中 将 状态 栏 的 颜色 指定 成 透明 色 ， 由 于 values-v21 目录 是 只 有 Android 5.0 及 
以 上 的 系统 才 会 去 读 取 的 ， 因 此 这 么 声明 是 没有 问题 的 。 

但 是 Android 5.0 之 前 的 系统 却 无 法 识别 FruitActivityTheme 这 个 主题 ， 因 此 我 们 还 需要 对 
values/styles.xml 文件 进行 修改 ， 如 下 所 示 : 


<resources> 
<!-- Base application theme. --> 
<style name="AppTheme" parent="Theme.AppCompat.Light.NoActionBar"> 
<!-- Customize your theme here. --> 


<item name="colorPrimary">@color/colorPrimary</item> 
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<item name="colorPrimaryDark">@color/colorPrimaryDark</item> 
<item name="colorAccent">@color/colorAccent</item> 
</style> 


<style name="FruitActivityTheme" parent="AppTheme"> 
</style> 


</resources> 


可 以 看 到 , 这 里 也 定义 了 一 个 FruitActivityTheme 主题 , 并且 parent 主题 也 是 AppTheme, 但 
是 它 的 内 部 是 空 的 。 因 为 Android 5.0 之 前 的 系统 无 法 指定 状态 栏 的 颜色 ， 因 此 这 里 什么 都 不 用 
做 就 可 以 了 。 

最 后 , 我 们 还 需要 让 FruitActivity 使 用 这 个 主题 才 可 以 , 修改 AndroidManifest.xml 中 的 代码 ， 
如 下 所 示 : 


<manifest xmlns:android="http://schemas.android.com/apk/res/android" 
package="com.example.materialtest"> 


<application 
android:allowBackup="true" 
android:icon="@mipmap/ic launcher" 
android:label="@string/app_name" 
android:supportsRtl="true" 
android:theme="@style/AppTheme"> 


<activity 
android:name=" .FruitActivity" 
android:theme="@style/FruitActivityTheme"> 
</activity> 
</application> 


</manifest> 


这 里 使 用 android:theme 属性 单独 给 FruitActivity 指定 了 FruitActivityTheme 这 个 主题 ， 这 
样 我 们 就 大 功 告 成 了 。 

现在 只 要 是 在 Android 5.0 及 以 上 的 系统 运行 MaterialTest 程序 ， 水 果 详 情 展示 界面 的 效果 就 
会 如 图 12.20 所 示 。 
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图 12.20 背景 图 和 状态 栏 融合 的 效果 
相信 我 ， 再 对 比 一 下 图 12.17 的 效果 ， 这 两 种 视觉 体验 绝对 不 是 在 一 个 档次 上 的 。 


12.8 小结 与 点 评 


学 完了 本 章 的 所 有 知识 , 你 有 没有 觉得 无 比 兴奋 呢 ? 反正 我 是 这 么 觉得 的 。 本 章 我 们 的 收获 
实在 是 太 多 了 ， 从 一 个 什么 都 没有 的 空 项 目 ， 经 过 一 章 的 学 习 ， 最 后 实现 了 一 个 功能 如 此 丰富 、 
界面 如 此 华丽 的 应 用 ， 还 有 什么 事情 比 这 个 更 让 我 们 有 成 就 感 吗 ? 

本 章 中 我 们 充分 利用 了 Design Support 库 、support-v4 库 、appcompat-v7 库 , 以 及 一 些 开源 项 
目 来 实现 一 个 了 高 度 Material 化 的 应 用 程序 ， 能 将 这 些 库 中 的 相关 控件 熟练 掌握 ， 你 的 Material 
Design 技术 就 算是 合格 了 。 

不 过 说 到 底 ， 我 仍然 还 是 在 以 一 个 开发 者 的 思维 给 你 讲解 Material Design， 侧 重 于 如 何 去 实 
现 这 些 效 果 。 而 实际 上 ，Material Design 的 设计 思维 和 设计 理念 才 是 更 加 重要 的 东西 ， 当 然 这 部 
分 内 容 应 该 是 UI 设计 人 员 去 学 习 的 ， 如 果 你 也 感 兴趣 的 话 ， 可 以 参考 一 下 Material Design 的 官 
方 文章 : https://material.google.com。 

现在 你 已 经 足 足 学 习 了 12 章 的 内 容 ， 对 Android 应 用 程序 开发 的 理解 应 该 比较 深刻 了 。 目 
前 系统 性 的 知识 几乎 都 已 经 讲 完 了 , 但 是 还 有 一 些 零散 的 高 级 技巧 在 等 待 着 你 , 那么 就 让 我 们 赶 
快 进入 到 下 一 章 的 学 习 当 中 吧 。 
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上 
继续 进 阶 一 一 你 还 应 该 掌握 的 高 级 技巧 


本 书 的 内 容 虽 然 已 经 接近 尾声 了 ， 但 是 千 万 不 要 因此 而 放松 ， 现 在 正 是 你 继续 进 阶 的 时 机 。 
相信 基础 性 的 Android 知识 已 经 没有 太 多 能 够 难 倒 你 的 了 ,那么 本 章 中 我 们 就 来 学 习 一 些 你 还 应 
该 掌握 的 高 级 技巧 吧 。 


13.1 全 局 获取 Context 的 技巧 


回想 这 么 久 以 来 我 们 所 学 的 内 容 , 你 会 发 现 有 很 多 地 方 都 需要 用 到 Context, 弹出 Toast 的 时 
候 需 要 ,启动 活动 的 时 候 需 要 ,发送 广播 的 时 候 需 要 ,操作 数据 库 的 时 候 需要 ,使 用 通知 的 时 候 


AaB ra ear ee 


或 许 目前 你 还 没有 为 得 不 到 Context 而 发 愁 过 ,因为 我 们 很 多 的 操作 都 是 在 活动 中 进行 的 ， 
而 活动 本 身 就 是 一 个 Context 对 象 。 但 是 ， 当 应 用 程序 的 架构 逐渐 开始 复杂 起 来 的 时 候 ， 很 多 
的 逻辑 代码 都 将 脱离 Activity 类 , 但 此 时 你 又 恰恰 需要 使 用 Context， 也许 这 个 时 候 你 就 会 感 
到 有 些 伤 脑筋 了 。 

举 个 例子 来 说 吧 , 在 第 9 章 的 最 佳 实践 环节 ,我 们 编写 了 一 个 HttpUtil 类 ,在 这 里 将 一 些 
通用 的 网 络 操作 封装 了 起 来 ， 代 码 如 下 所 示 : 


public class HttpUtil { 


public static void sendHttpRequest(final String address, final 
HttpCallbackListener listener) { 
new Thread(new Runnable() { 
@Override 
public void run() { 
HttpURLConnection connection = null; 
try { 
URL url = new URL(address); 
connection = (HttpURLConnection) url.openConnection(); 
connection.setRequestMethod( "GET"); 
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connection.setConn 
connection. 
connection.setDoIn 
Connection.setDo0u 
InputStream in C 
BufferedReader rea 
InputStreamRea 
StringBuilder resp 
String line; 
while ((line rea 
response.appen 


} 


if (listener != nu 


ectTimeout (8000); 


setReadTimeout (8000); 


put (true); 

tput (true); 
onnection.getInputStream(); 
der new BufferedReader (new 
der(in)); 

onse new StringBuilder(); 


der.readLine()) != null) 


d(line); 


{ 


LL) { 


// 回调 onFinish() 方 法 


listener.onFin 
} 
} catch (Exception e) 
if (Listener != nu 


ish(response.toString()); 


{ 


LL) { 


// 回调 OnError() 方 法 


Listener.onErr 
} 
} finally { 
if (connection != 
connection.dis 


}).start(); 


这 里 使 月 


or(e); 


nuLL) { 
Connect () ; 


日 sendHttpRequest() 方 法 来 发 送 HTTP 请 求 显 然 是 没有 问题 的 ， 并 且 我 们 还 可 以 


在 回调 方法 中 处 理 服务 器 返回 的 数据 。 但 现在 我 们 想 对 sendHttpRequest ( ) 方 法 进行 一 些 优化 ， 


当 检 测 到 网 络 不 存在 的 时 候 就 给 用 户 一 个 Toast 


提示 ， 并 且 不 再 执行 后 面 的 代码 。 看 似 一 个 挺 简 


单 的 功能 ， 可 是 却 存在 一 个 让 人 头疼 的 问题 ， 红 


HttpUtil 类 中 显然 是 获取 不 到 Context 对 象 的 ， 这 
名 ， 大 不 了 在 sendHttpRequest () 方 法 中 添加 一 个 


人 


其 实 要 想 快 速 


坚决 这 个 问题 也 很 简 身 


出 Toast 提示 需要 一 个 Context 参数 ， 而 我 们 在 
该 怎么 办 呢 ? 


Context 参数 就 行 了 嘛 ， 于 是 可 以 将 HttpUtil 中 的 代码 进行 如 下 修改 : 


public class HttpUtil { 


public static void sendHttpRequest 
final String address, fina 
if (!isNetworkAvailable()) { 


(final Context context, 
lL HttpCallbackListener listener) { 


Toast.makeText(context, "network is unavailable", 
Toast .LENGTH_ SHORT) .show() ; 


return; 
} 


new Thread(new Runnable() { 
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@Override 
public void run() { 


} 
}).start(); 
} 


private static boolean isNetworkAvailable() { 
} 

} 

可 以 看 到 ,这 里 在 方法 中 添加 了 一 个 Context 参数 ,并 且 假 设 有 一 个 ijsNetworkAvailable() 
方法 用 于 判断 当前 网 络 是 否 可 用 ， 如 果 网 络 不 可 用 的 话 就 弹出 Toast 提示， 并 将 方法 retum 掉 。 

虽说 这 也 确实 是 一 种 解决 方案 ,但 是 却 有 点 推 印 责任 的 嫌疑 ， 因 为 我 们 将 获取 Context 的 
任务 转移 给 了 sendHttpRequest() 方 法 的 调用 方 ， 至 于 调用 方 能 不 能 得 到 Context 对 象 ， 那 就 
不 是 我 们 需要 考虑 的 问题 了 。 

由 此 可 以 看 出 ， 在 某 些 情况 下 ， 获 取 Context 并 非 是 那么 容易 的 一 件 事 ， 有 时 候 还 是 挺 伤 
脑筋 的 。 不 过 别 担心 ， 下 面 我 们 就 来 学 习 一 种 技巧 ， 让 你 在 项 目的 任何 地 方 都 能 够 轻松 获取 到 
Context。 

Android 提供 了 一 个 Application 类 , 每 当 应 用 程序 启动 的 时 候 , 系统 就 会 自动 将 这 个 类 进 
行 初始 化 。 而 我 们 可 以 定制 一 个 自己 的 AppLication 类 ， 以 便于 管理 程序 内 一 些 全 局 的 状态 信 
息 ， 比 如 说 全 局 Context。 

定制 一 个 自己 的 AppLication 其 实 并 不 复杂 , 首先 我 们 需要 创建 一 个 MyAppLication 类 继 
承 自 AppLication， 代 码 如 下 所 示 : 


public class MyApplication extends AppLication { 


/ 


private static Context context; 


@Override 
public void onCreate() { 

context = getApplicationContext(); 
} 


public static Context getContext() { 
return context; 


} 
} 


可 以 看 到 ，MyApplication 中 的 代码 非常 简单 。 这 里 我 们 重 写 了 父 类 的 onCreate() 方 法 ， 
并 通过 调用 getApplicationContext() 方 法 得 到 了 一 个 应 用 程序 级 别 的 Context， 然后 又 提供 
了 一 个 静态 的 getContext() 方 法 ， 在 这 里 将 刚才 获取 到 的 Context 进行 返回 。 
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接 下 来 我 们 需要 告知 系统 ， 当 程序 启动 的 时 候 应 该 初始 化 MyAppLication 类 ， 而 不 是 默认 
的 AppLication 类 。 这 一 步 也 很 简单 ， 在 AndroidManifestxml 文件 的 <appLication> 标 签 下 进 
行 指定 就 可 以 了 ， 代 码 如 下 所 示 : 
<manifest xmlns:android="http://schemas.android.com/apk/res/android" 
package="com.example.networktest" 


android:versionCode="1" 
android:versionName="1.0" > 


<application 
android:name="com.example.networktest .MyApplication" 
> 


</application> 
</manifest> 


注意 这 里 在 指定 MyApplication 的 时 候 一 定 要 加 上 完整 的 包 名 ， 不然 系统 将 无 法 找到 这 


这 样 我 们 就 已 经 实现 了 一 种 全 局 获取 Context 的 机 制 ， 之 后 不 管 你 想 在 项 目的 任何 地 方 使 
用 Context， 只 需要 调用 一 下 MyApplication.getContext() 就 可 以 了 。 
那么 接 下 来 我 们 再 对 sendHttpRequest() 方 法 进行 优化 ， 代 码 如 下 所 示 : 


public static void sendHttpRequest(final String address, final HttpCallbackListener 
listener) { 
if (!isNetworkAvailable()) { 
Toast.makeText (MyApplication.getContext(), "network is unavailable", 
Toast .LENGTH SHORT).show(); 
return; 


} 

可 以 看 到 ，sendHttpRequest() 方 法 不 需要 再 通过 传 参 的 方式 来 得 到 Context 对 象 ， 而 是 
调用 一 下 MyApplication.getContext() 方 法 就 可 以 了 。 有 了 这 个 技巧 ， 你 再 也 不 用 为 得 不 到 
Context 对 象 而 发 愁 了 

后 我 们 再 回顾 一 下 6.5.2 小 节 学 过 的 内 容 ， 当 时 为 了 让 LitePal 可 以 正常 工作 ， 要 求 必 须 在 
AndroidManifest.xml 中 配置 如 下 内 容 : 


<application 
android:name="org.litepal .LitePalApplication" 
和 


人 
道理 也 是 一 样 的 ,因为 经 过 这 样 的 配置 之 后 ，LitePal 就 能 在 内 部 自动 获取 到 Context 了 。 


es 如 果 我 们 已 经 配置 过 了 自己 的 AppLication 怎么 办 ? 这 样 
岂 不 是 和 LitePalApplication 冲突 了 ? 没 错 ， 任 何 一 个 项 目 都 只 能 配置 一 个 AppLication， 
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对 于 这 种 情况 ，LitePal 提供 了 很 简单 的 解决 方案 ， 那 就 是 在 我 们 自己 的 AppLication 中 去 调用 
LitePal 的 初始 化 方法 就 可 以 了 ， 如 下 所 示 : 


public class MyApplication extends Application { 


7 


private static Context context; 


GOverride 

public void onCreate() { 
context = getAppLicationContext() ; 
LitePal.initialize(context); 

} 


public static Context getContext() { 
return context; 


} 
} 


使 用 这 种 写法 ， 就 相当 于 我 们 把 全 局 的 Context 对 象 通过 参数 传递 给 了 LitePal， 效 果 和 在 
AndroidManifest.xml 中 配置 LitePalApplication 是 一 模 一 样 的 。 
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Intent 的 用 法 相信 你 已 经 比较 熟悉 了 , 我 们 可 以 借助 它 来 启动 活动 、 发 送 广播 、 启 动 服务 等 。 
在 进行 上 述 操作 的 时 候 ， 我 们 还 可 以 在 Intent 中 添加 一 些 附加 数据 ， 以 达到 传 值 的 效果 ， 比 如 在 
FirstActivity 中 添加 如 下 代码 : 

Intent intent = new Intent(FirstActivity.this, SecondActivity.class); 

intent ,putExtra("Sstring data", "hello"); 

intent ,putEXxtra("int data", 100); 

startActivity(intent); 

这 里 调用 了 Intent 的 putExtra() 方 法 来 添加 要 传递 的 数据 ， 之 后 在 SecondActivity 中 就 
可 以 得 到 这 些 值 了 ， 代 码 如 下 所 示 : 


getIntent().getStringExtra("string data"); 
getIntent() .getIntExtra("int data", 0); 


但 是 不 知道 你 有 没有 发 现 ，putExtra() 方 法 中 所 文 持 的 数据 类 型 是 有 限 的 ， 虽然 常用 的 一 
些 数据 类 型 它 都 会 支持 , 但 是 当 你 想 去 传递 一 些 自 定义 对 象 的 时 候 ， 就 会 发 现 无 从 下 手 。 不 用 担 
心 ， 下 面 我 们 就 学 习 一 下 使 用 Intent 来 传递 对 象 的 技巧 。 


13.2.1 Serializable 方式 


使 用 Intent 来 传递 对 象 通常 有 两 种 实现 方式 : Serializable 和 Parcelable, 本 小 节 中 我 们 先 来 学 
习 一 下 第 一 种 实现 方式 。 
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Serializable 是 序列 化 的 意思 ,表示 将 一 个 对 象 转换 成 可 存储 或 可 传输 的 状态 。 序 列 化 后 的 对 


象 可 以 在 网 络 上 进行 传输 ,也 可 以 存储 到 本 地 。 至 于 序列 化 的 方法 也 很 简单 ， 只 需要 让 


实现 Serializable 这 个 接口 就 可 以 了 。 


个 类 去 


比如 说 有 一 个 Person 类 ， 其 中 包含 了 name 和 age 这 两 个 字段 ， 想 要 将 它 序列 化 就 可 以 这 


public class Person impLements SeriaLizabtLet 


private String name; 
private int age; 


public String getName() { 
return name; 


} 


public void setName(String name) { 
this.name = name; 


} 


public int getAge() { 
return age; 


} 


public void setAge(int age) { 
this.age = age; 
} 


其 中 ，get 、set 方法 都 是 用 于 赋值 和 读 取 字 段 数据 的 ， 最 重要 的 部 分 是 在 第 一 行 。 这 


里 让 


Person 类 去 实现 了 Serializable 接口 ， 这 样 所 有 的 Person 对 象 就 都 是 可 序列 化 的 了 。 


接 下 来 在 FirstActivity 中 的 写法 非常 简单 : 


Person person = new Person(); 

person.setName("Tom"); 

person.setAge(20); 

Intent intent = new Intent(FirstActivity.this, SecondActivity.class); 
intent.putExtra("person data", person); 

startActivity(intent); 


可 以 看 到 ， 这 里 我 们 创建 了 一 个 Person 的 实例 ， 然 后 就 直接 将 它 传人 到 putExtra 


中 了 。 由 于 Person 类 实现 了 Serializable 接口 ， 所 以 才 可 以 这 样 写 。 
接 下 来 在 SecondActivity 中 获取 这 个 对 象 也 很 简单 ， 写 法 如 下 : 
Person person = (Person) getIntent().getSerializableExtra("person data"); 


这 里 调用 了 getSerializableExtra() 方 法 来 获取 通过 参数 传递 过 来 的 序列 化 对 象 
将 它 向 下 转型 成 Person 对 象 ， 这 样 我 们 就 成 功 实现 了 使 用 Intent 来 传递 对 象 的 功能 了 


,接着 再 


() 方 法 
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13.2.2 ”Parcelable 方式 


除了 Serializable 之 外 ， 使 用 Parcelable 也 可 以 实现 相同 的 效果 ， 不 过 不 同 于 将 对 象 进行 序列 


化 ，Parcelable 方式 的 实现 原理 是 将 一 个 完整 的 对 象 进行 分 解 ， 而 分 解 后 的 


所 支持 的 数据 类 型 ， 这 样 也 就 实现 传递 对 象 的 功能 
下 面 我 们 来 看 一 下 Parcelable 的 实现 方式 ， 修 改 Person 中 的 代码 ， 如 下 所 示 


public class Person impLements Parcelable { 


} 


private String name; 


private int age; 


@Override 
public int describeContents() { 
return 0; 


} 


@Override 

public void writeToParceL(ParceL dest, int flags) { 
dest.writeString(name); // 写 出 name 
dest.writeInt(age); // 写 出 age 

} 


部 分 都 是 Intent 


public static final Parcelable.Creator<Person> CREATOR = new Parcelable. 


Creator<Person>() { 


@Override 

public Person createFromParceL(ParceL source) { 
Person person = new Person(); 
person.name = source.readString(); // 读 取 name 
person.age = source.readInt(); // 读 取 age 
return person; 

} 


@Override 
public Person[] newArray(int size) { 
return new Person[size]; 
} 
}; 


Parcelable 的 实现 方式 要 稍微 复杂 一 些 。 可 以 看 到 ， 首 先 我 们 让 Person 类 去 实现 了 


Parcelable 接口 , 这 样 就 必须 


EE 写 describeContents() 和 writeToParcel() 这 两 个 方法 。 其 


ey 


中 describeContents() 方 法 直接 返回 0 就 可 以 了 ， 而 writeToParcel() 方 法 中 我 们 需要 调用 


Parcel 的 writeXxx() 方 法 , 将 Person 类 中 的 字段 
writeString() 方 法 ， 整 型 数据 就 调用 writeInt() 方 法 ， 以 此 类 推 。 


写 出 。 注 意 ， 字 符 串 型 数据 就 调用 
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除 此 之 外 ， 我 们 还 必须 在 Person 类 中 提供 一 个 名 为 CREATOR 的 常量 ， 这 里 创建 了 
Parcelable.Creator 接口 的 一 个 实现 ， 并 将 泛 型 指定 为 Person。 接 着 需要 重 写 createFrom- 
ParceL() 和 newArray() 这 两 个 方法 ,在 createFromParcel() 方 法 中 我 们 要 去 读 取 刚才 写 出 的 
name 和 age 字段 ， 并 创建 一 个 Person 对 象 进行 返回 ， 其 中 name 和 age 都 是 调用 Parcel 的 
readXxx() 方 法 读 取 到 的 ， 注 意 这 里 读 取 的 顺序 一 定 要 和 刚才 写 出 的 顺序 完全 相同 。 而 
newArray() 方 法 中 的 实现 就 简单 多 了 ， 只 需要 new 出 一 个 Person 数组 ， 并 使 用 方法 中 传人 的 
size 作为 数组 大 小 就 可 以 了 。 


接 下 来 , 在 FirstActivity 中 我 们 仍然 可 以 使 用 相同 的 代码 来 传递 Person 对 象 ， 只 不 过 
在 SecondActivity 中 获取 对 象 的 时 候 需要 稍 加 改动 ， 如 下 所 示 : 


Person person = (Person) getIntent() ,getParceLabLeExtra("person data"); 


注意 , 这 里 不 再 是 调用 getSerializableExtra() 方 法 , 而 是 调用 getParcelableExtra() 
方法 来 获取 传递 过 来 的 对 象 了 ， 其 他 的 地 方 都 完全 相同 。 

这 样 我 们 就 把 使 用 Intent 来 传递 对 象 的 两 种 实现 方式 都 学 习 完 了 ， 对 比 一 下 ，Serializable 的 
方式 较为 简单 ， 但 由 于 会 把 整个 对 象 进行 序列 化 ， 因 此 效率 会 比 Parcelable 方式 低 一 些 ， 所 以 在 
通常 情况 下 还 是 更 加 推荐 使 用 Parcelable 的 方式 来 实现 Intent 传递 对 象 的 功能 。 
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早 在 第 1 章 的 1.4 节 中 我 们 就 已 经 学 过 了 Android 日 志 工 具 的 用 法 ， 并 且 日 志 工 具 也 确实 贯 
穿 了 我 们 整 本 书 的 学 习 ， 基 本 上 每 一 章 都 有 用 到 过 。 虽 然 Android 中 自 带 的 日 志 工 具 功 能 非常 强 
大 ， 但 也 不 能 说 是 完全 没有 缺点 ， 例 如 在 打印 日 志 的 控制 方面 就 做 得 不 够 好 。 

打 个 比方 , 你 正在 编写 一 个 比较 庞大 的 项 目 , 期 间 为 了 方便 调试 ,在 代码 的 很 多 地 方 都 打印 
了 大 量 的 日 志 。 最 近 项 目 已 经 基本 完成 了 , 但 是 却 有 一 个 非常 让 人 头疼 的 问题 , 之 前 用 于 调试 的 
那些 日 志 , 在 项 目 正式 上 线 之 后 仍然 会 照常 打印 ,这样 不 仅 会 降低 程序 的 运行 效率 , 还 有 可 能 将 
一 些 机 密 性 的 数据 泄露 出 去 。 

那 该 怎么 办 呢 ? 难道 要 一 行 一 行 地 把 所 有 打印 日 志 的 代码 都 删 掉 ?” 显然 这 不 是 什么 好 点 子 ， 
不 仅 费时 费力 ,而 且 以 后 你 继续 维护 这 个 项 目的 时 候 可 能 还 会 需要 这 些 日 志 。 因 此 ， 最 理想 的 情 
况 是 能 够 自由 地 控制 日 志 的 打印 ， 当 程序 处 于 开发 阶段 时 就 让 日 志 打 印 出 来 ， 当 程序 上 线 了 之 后 
就 把 日 志 屏 蔽 掉 。 
看 起 来 好 像 是 挺 高 级 的 一 个 功能 ,其 实 并 不 复杂 , 我 们 只 需要 定制 一 个 自己 的 日 志 工 具 就 可 
以 轻松 完成 了 。 比 如 新 建 一 个 LogUtit 类 ， 代 码 如 下 所 示 : 

public class LogUtil { 


public static final int VERBOSE = 1; 


public static final int DEBUG = 2; 
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ll 
(LU 


public static final int INFO 


public static final int WARN 


ll 
~ 


public static final int ERROR = 
public static final int NOTHING = 6; 
public static int level = VERBOSE; 


public static void v(String tag, String msg) { 
if (level <= VERBOSE) { 
Log.v(tag, msg); 


public static void d(String tag, String msg) { 
if (level <= DEBUG) { 
Log.d(tag, msg); 


public static void i(String tag, String msg) { 
if (level <= INFO) { 
Log.i(tag, msg); 


public static void w(String tag, String msg) { 
if (level <= WARN) { 
Log.w(tag, msg); 


public static void e(String tag, String msg) { 
if (level <= ERROR) { 
Log.e(tag, msg); 


可 以 看 到 , 我 们 在 LogUtil 中 先是 定义 了 VERBOSE、DEBUG、INFO、WARN、ERROR、NOTHING 
这 6 个 整 型 常量 ,并且 它 们 对 应 的 值 都 是 递增 的 。 然 后 又 定义 了 一 个 静态 变量 LeveL， 可 以 将 它 
的 值 指 定 为 上 面 6 个 常量 中 的 任意 一 个 。 


接 下 来 我 们 提供 了 v()、d()、i()、w()、e() 这 5 个 自 定义 的 日 志方 法 ， 在 其 内 部 分 别 调 
用 了 Log.v()、Log.d()、Log.i()、Log.w()、Log.e() 这 5 个 方法 来 打印 日 志 ， 只 不 过 在 这 些 
自 定义 的 方法 中 我 们 都 加 入 了 一 个 if 判断 , 只 有 当 Level 的 值 小 于 或 等 于 对 应 日 志 级 别 值 的 时 
候 ， 才 会 将 日 志 打 印 出 来 。 
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这 样 就 把 一 个 自 定义 的 日 志 工 具 创 建 好 了 , 之 后 在 项 目 里 我 们 可 以 像 使 用 普通 的 日 志 工 具 一 
样 使 用 Logutil， 比 如 打印 一 行 DEBUG 级 别 的 日 志 就 可 以 这 样 写 : 

LogUtil.d("TAG", "debug log"); 

打印 一 行 WARN 级 别 的 日 志 就 可 以 这 样 写 : 

LogUtil.w("TAG", "warn Log " ) ; 

然后 我 们 只 需要 修改 Level 变量 的 值 , 就 可 以 自由 地 控制 日 志 的 打印 行为 了 。 比 如 让 Level 


等 于 VERBOSE 就 可 以 把 所 有 的 日 志 都 打印 出 来 ， 让 Level 等 于 WARN 就 可 以 只 打印 警告 以 上 级 
别 的 日 志 ， 让 Level 等 于 NOTHING 就 可 以 把 所 有 日 志 都 屏蔽 掉 。 


使 用 了 这 种 方法 之 后 ， 刚 才 所 说 的 那个 问题 就 不 复 存 在 了 ， 你 只 需要 在 开发 阶段 将 Level 
定 成 VERBO0SE， 当 项 目 正式 上 线 的 时 候 将 Level 指定 成 NOTHING 就 可 以 了 。 


13.4 调试 Android 程序 


当 开 发 过 程 中 遇 到 一 些 奇怪 的 bug,， 但 又 迟 迟 定位 不 出 来 原因 是 什么 的 时 候 ， 最 好 的 解决 办 
法 就 是 调试 了 。 调试 允许 我 们 逐 行 地 执行 代码 ,并 可 以 实时 观察 内 存 中 的 数据 ， 从 而 能 够 比较 轻 
易 地 查 出 问题 的 原因 。 那 么 本 节 中 我 们 就 来 学 习 一 下 使 用 Android Studio 来 调试 Android 程序 的 
技巧 。 

还 记得 在 第 5 章 的 最 佳 实践 环节 中 编写 的 那个 强制 下 线程 序 吗 ?就 让 我 们 通过 这 个 例子 来 
学 习 一 下 Android 程序 的 调试 方法 吧 。 这 个 程序 中 有 一 个 登录 功能 , 比如 说 现在 登录 出 现 了 问题 ， 
我 们 就 可 以 通过 调试 来 定位 问题 的 原因 。 

不 用 多 说 ,调试 工作 的 第 一 步 上 骨 定 是 添加 断 点 ， 这 里 由 于 我 们 要 调试 登录 部 分 的 问题 ,所 以 
断 点 可 以 加 在 登录 按钮 的 点 击 事件 里 面 。 添加 断 点 的 方法 也 很 简单 ， 只 需要 在 相应 代码 行 的 左边 
点 击 一 下 就 可 以 了 ， 如 图 13.1 所 示 。 


login = (Buttol ee 各 四 iewById(R. id. Login); 
login. setOnClic| er (new View.OnClickListener() { 
ov 


ra cde vt 
ring ac untEdit.getText() .toString(); 
ee me ca rp rdEdit.getText(). oStrh ing(); 


图 13.1 添加 断 点 
如 果 想 要 取消 这 个 断 点 ， 对 着 它 再 次 点 击 就 可 以 了 。 


添加 好 了 断 点 , 接 下 来 就 可 以 对 程序 进行 调试 了 , 点击 Android Studio 顶部 工具 栏 中 的 Debug 
按钮 (图 13.2 中 最 右边 的 按钮 )， 就 会 使 用 调试 模式 来 启动 程序 。 


[Eappz| > 菲 


图 13.2 ”调试 按钮 
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等 到 程序 运行 起 来 的 时 候 ， 首 先 会 看 到 一 个 提示 框 ， 如 图 13.3 所 示 。 


3 BG 1:09 


Waiting For Debugger 


Application 
BroadcastBestPractice (process 
com.example.broadcastbestpractice) is 
waiting for the debugger to attach. 


FORCE CLOSE 


图 13.3 “等待 调试 需 提 示 框 


这 个 框 很 快 就 会 自动 消失 ,然后 在 输入 框 里 输入 账号 和 密码 ,并 点 击 Login 按 钮 ,这 时 Android 
Studio 就 会 自动 打开 Debug 窗口 ， 如 图 13.4 所 示 。 


@Override 
时 protected void onCreate(Bundte savedInstanceState) { 
super.onCreate(savedInstanceState); 
setContentView(R. layout .activity_login); 
accountEdit = (EditText) findViewById(R.id.account); 
passwordEdit = (EditText) findViewById(R,id.password); 
login = (Button) findViewById(R.id. login); 
Login. setOnClickListener(new View.OnClickListener() { 
@Override 


时 public void onClick(View v) { 8,368-1689,546 制 
© BEE 
> String password = passwordEdit,getText().toString( 
if (account.equals("admin") && password.equals("123456")) { | 
Intent intent = new Intent(LoginActivity.this, MainActivity.class); 
startActivity(intent); 
finish(); 
} else { 
Toast.makeText (LoginActivity. this, "account or password is invalid", 
Toast .LENGTH_SHORT) .show(); 
} 
} 
Ds; 
} 
Debug’ app 绚 " 土 
Debugger | 国 console | 性 至 这 主机 和 当 正品 
局 Frames + 三 variables | 


了 
nl 
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bp & passwordEdit = {AppCompatEditText@4324} "android.support.v7.widget.AppComp ... View, 
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run0:21153, ViewSPerformClick (android view) Ep SR ee 


handleCallback0:739, Handler (android.0s) 
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给 | main0:5417, ActivityThread (android.app) 
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图 13.4 Debug 窗口 


接 下 来 每 按 一 次 F8 健 ， 代 码 就 会 向 下 执行 一 行 ， 并 且 通 过 Variables 视图 还 可 以 看 到 内 存 中 
的 数据 ， 如 图 13.5 所 示 。 
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4318} 
n@4320} "android.supportv7.widget.AppCompatButtontle9a5. View 


图 13.5 ”Variables 视图 


可 以 看 到 ,我 们 从 输入 框 里 获取 到 的 账号 密码 分 别 是 abc 和 123， 而 程序 里 要 求 正确 的 账号 
密码 是 admin 和 123456， 所 以 登录 才 会 出 现 问 题 。 这 样 我 们 就 通过 调试 的 方式 轻松 地 把 问题 定 
位 出 来 了 ， 调 试 完成 之 后 点 击 Debug 窗口 中 的 Stop 按钮 (图 13.6 中 最 下 边 的 按钮 ) 来 结束 调试 
即 可 。 


银 
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图 13.6 ”结束 调试 按钮 


这 种 调试 方式 虽然 完全 可 以 正常 工作 ， 但 在 调试 模式 下 ， 程 序 的 运行 效率 将 会 大 大 地 降低 ， 
如 果 你 的 断 点 加 在 一 个 比较 靠 后 的 位 置 , 需要 执行 很 多 的 操作 才能 运行 到 这 个 断 点 , 那么 前 面 这 
些 操 作 就 都 会 有 一 些 卡 顿 的 感觉 。 没 关系 ，Android 还 提供 了 另外 一 种 调试 的 方式 ， 可 以 让 程序 
随时 进入 到 调试 模式 ， 下 面 我 们 就 来 尝试 一 下 。 

这 次 不 需要 选择 调试 模式 来 启动 程序 了 , 就 使 用 正常 的 方式 来 启动 程序 。 由 于 现在 不 是 在 调 
试 模式 下 ,程序 的 运行 速度 比较 快 ， 可 以 先 把 账号 和 密码 输入 好 。 然 后 点 击 Android Studio 顶部 
工具 栏 的 Attach debugger to Android process 按钮 ( 图 13.7 中 最 左边 的 按钮 )。 


应 所 图 


图 13.7 动态 调试 按钮 
此 时 会 弹出 一 个 进程 选择 提示 框 ， 如 图 13.8 所 示 。 


(choose process Wo Ex 
Select a process to attach to: 
DD Show all processes 
Debugger: | Auto 日 


思 Emulator Nexus_5X_API_24 Android 7 


com.example.broadcastbestpractice 


WE [ee 


[HH 


图 13.8 ”进程 选择 提示 市 
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这 里 目前 只 列 出 了 一 个 进程 ， 也 就 是 我 们 当前 程序 的 进程 。 选 中 这 个 进程 ， 然 后 点 击 OK 按 
钮 ， 就 会 让 这 个 进程 进入 到 调试 模式 了 。 

接 下 来 在 程序 中 点 击 Login 按钮 ，Android Studio 同样 也 会 自动 打开 Debug 窗口 ， 之 后 的 流 
程 就 都 是 相同 的 了 。 相 比 起 来 ， 第 二 种 调试 方式 会 比 第 一 种 更 加 灵活 ， 也 更 加 常用 。 


13.5 ”创建 定时 任务 


Android 中 的 定时 任务 一 般 有 两 种 实现 方式 ， 一 种 是 使 用 Java API 里 提供 的 Timer 类 ,一 种 
是 使 用 Android 的 Alarm 机 制 。 这 两 种 方式 在 多 数 情况 下 都 能 实现 类 似 的 效果 ,但 Timer 有 一 个 
明显 的 短 板 , 它 并 不 太 适 用 于 那些 需要 长 期 在 后 台 运 行 的 定时 任务 。 我 们 都 知道 , 为 了 能 让 电池 
更 加 耐用 ， 每 种 手机 都 会 有 自己 的 休眠 策略 ，Android 手机 就 会 在 长 时 间 不 操作 的 情况 下 自动 让 
CPU 进入 到 睡眠 状态 , 这 就 有 可 能 导致 Timer 中 的 定时 任务 无 法 正常 运行 。 而 Alarm 则 具有 唤醒 
CPU 的 功能 ， 它 可 以 保证 在 大 多 数 情况 下 需要 执行 定时 任务 的 时 候 CPU 都 能 正常 工作 。 需 要 注 
意 ， 这 里 唤醒 CPU 和 唤醒 屏幕 完全 不 是 一 个 概念 ， 千 万 不 要 产生 混 消 。 


13.5.1 _ Alarm 机 制 


那么 首先 我 们 来 看 一 下 Alarm 机 制 的 用 法 吧 ,其 实 并 不 复杂 ,主要 就 是 借助 了 ALarmManager 
类 来 实现 的 。 这 个 类 和 NotificationManager 有 点 类 似 ， 都 是 通过 调用 Context 的 getSystem- 
Service( ) 方 法 来 获取 实例 的 ， 只 是 这 里 需要 传 入 的 参数 是 Context .ALARM SERVICE。 因此， 
获取 一 个 ALarmManager 的 实例 就 可 以 写成 : 

AlarmManager manager = (AlarmManager) getSystemService(Context.ALARM SERVICE); 


接 下 来 调用 ALarmManager 的 set() 方 法 就 可 以 设置 一 个 定时 任务 了 , 比如 说 想 要 设 定 一 个 
任务 在 10 秒 钟 后 执行 ， 就 可 以 写成 : 

long triggerAtTime = SystemClock.elapsedRealtime() + 10 * 1000; 

manager.set(AlarmManager .ELAPSED REALTIME WAKEUP, triggerAtTime, pendingIntent); 

上 面 的 两 行 代 码 你 不 一 定 能 看 得 明白 ,因为 set() 方 法 中 需要 传人 的 3 个 参数 稍微 有 点 复 厅 ， 
下 面 我 们 就 来 仔细 地 分 析 一 下 。 第 一 个 参数 是 一 个 整 型 参数 ， 用 于 指定 ALarmManager 的 工作 类 
型 ,有 4 种 值 可 选 ,分 别 是 ELAPSED REALTIME .ELAPSED REALTIME WAKEUP .RTC 和 RTC WAKEUP。 
其 中 ELAPSED_REALTIME 表示 让 定时 任务 的 触发 时 间 从 系统 开机 开始 算 起 ， 但 不 会 唤醒 CPU。 
ELAPSED_REALTIME_WAKEUP 同样 表示 让 定时 任务 的 触发 时 间 从 系统 开机 开始 算 起 ， 但 会 唤醒 
CPU。RTC 表示 让 定时 任务 的 触发 时 间 从 1970 年 1 月 1 日 0 点 开始 算 起 , 但 不 会 唤醒 CPU。 
RTC_WAKEUP 同样 表示 让 定时 任务 的 触发 时 间 从 1970 年 1 月 1 日 0 点 开始 算 起 ,但 会 唤醒 CPU。 
使 用 SystemClock.elapsedRealtime() 方 法 可 以 获取 到 系统 开机 至 今 所 经 历时 间 的 毫秒 数 ， 
使 用 System.currentTimeMillis() 方 法 可 以 获取 到 1970 年 1 月 1 日 0 点 至 今 所 经 历时 间 的 
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然后 看 一 下 第 二 个 参数 ， 这 个 参数 就 好 理解 多 了 ， 就 是 定时 任务 触发 的 时 间 ， 以 毫秒 为 单位 。 
如 果 第 一 个 参数 使 用 的 是 ELAPSED_REALTIME 或 ELAPSED REALTIME WAKEUP， 则 这 里 传人 开机 
至 今 的 时 间 再 加 上 延迟 执行 的 时 间 。 如 果 第 一 个 参数 使 用 的 是 RTC 或 RTC_WAKEUP， 则 这 里 传人 
1970 年 1 月 1 日 0 点 至 今 的 时 间 再 加 上 延迟 执行 的 时 间 。 

第 三 个 参数 是 一 个 PendingIntent， 对 于 它 你 应 该 已 经 不 会 陌生 了 吧 。 这 里 我 们 一 般 会 调 
用 getService() 方 法 或 者 getBroadcast ( ) 方 法 来 获取 一 个 能 够 执行 服务 或 广播 的 Pending - 
Intent 。 这 样 当 定时 任务 被 触发 的 时 候 ， 服 务 的 onStartCommand() 方 法 或 广播 接收 器 的 
onReceive() 方 法 就 可 以 得 到 执行 。 

了 解 了 set() 方 法 的 每 个 参数 之 后 ， 你 应 该 能 想到 ， 设 定 一 个 任务 在 10 秒 钟 后 执行 也 可 以 
写成 : 

Long triggerAtTime = System.currentTimeMillis() + 10 * 1000; 

manager.set(AlarmManager .RTC WAKEUP, triggerAtTime, pendingIntent); 

那么 , 如 果 我 们 要 实现 一 个 长 时 间 在 后 台 定 时 运行 的 服务 该 怎么 做 呢 ? 其 实 很 简单 ,首先 新 
建 一 个 普通 的 服务 ， 比 如 把 它 起 名 叫 LongRunningService， 然 后 将 触发 定时 任务 的 代码 写 到 
onStartCommand() 方 法 中 ， 如 下 所 示 : 


public class LongRunningService extends Service { 


@Override 
public IBinder onBind(Intent intent) { 
return null; 


} 


@Override 
public int onStartCommand(Intent intent, int flags, int startId) { 
new Thread(new Runnable() { 
@Override 
public void run() { 
// 在 这 里 执行 具体 的 逻辑 操作 
} 
}).start(); 
AlarmManager manager = (AlarmManager) getSystemService(ALARM SERVICE); 
int anHour = 60 * 60 * 1000; // 这 是 一 小 时 的 毫秒 数 
Long triggerAtTime = SystemClock.elapsedRealtime() + anHour; 
Intent i = new Intent(this, LongRunningService.class); 
PendingIntent pi = PendingIntent.getService(this, 0, i, 0); 
manager.set(AlarmManager.ELAPSED REALTIME WAKEUP, triggerAtTime, pi); 
return super.onStartCommand(intent, flags, startId); 


} 


可 以 看 到 , 我 们 先是 在 onStartCommand() 方 法 中 开启 了 一 个 子 线程 ,这 样 就 可 以 在 这 里 执 
行 具体 的 逻辑 操作 了 。 之 所 以 要 在 子 线程 里 执行 逻辑 操作 ， 是 因为 逻辑 操作 也 是 需要 耗 时 的 ， 如 
果 放 在 主线 程 里 执行 可 能 会 对 定时 任务 的 准确 性 造成 轻微 的 影响 。 
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创建 线程 之 后 的 代码 就 是 我 们 刚刚 讲解 的 Alarm 机 制 的 用 法 了 ， 先 是 获取 到 了 ALarm- 
Manager 的 实例 , 然后 定义 任务 的 触发 时 间 为 一 小 时 后 , 再 使 用 PendingIntent 指定 处 理 定时 任务 
的 服务 为 LongRunningService， 最 后 调用 set ( ) 方 法 完成 设 定 。 

这 样 我 们 就 将 一 个 长 时 间 在 后 台 定 时 运行 的 服务 成 功 实 现 了 。 因 为 一 旦 启动 了 
LongRunningService， 就 会 在 onStartCommand() 方 法 里 设 定 一 个 定时 任务 ， 这 样 一 小 时 后 将 会 
再 次 启动 LongRunningServicee， 从 而 也 就 形成 了 一 个 永久 的 循环 ， 保 证 LongRunningService 的 
onStartCommand () 方 法 可 以 每 隔 一 小 时 就 执行 一 次 。 


最 后 ， 只 需要 在 你 想 要 启动 定时 服务 的 时 候 调 用 如 下 代码 即 可 : 


Intent intent = new Intent(context, LongRunningService.class); 
context.startService(intent); 


另外 需要 注意 的 是 ,从 Android 4.4 系统 开始 ，Alarm 任务 的 触发 时 间 将 会 变 得 不 准确 , 有 可 
能 会 延迟 一 段 时 间 后 任务 才能 得 到 执行 。 这 并 不 是 个 bug， 而 是 系统 在 耗 电 性 方面 进行 的 优化 。 
系统 会 自动 检测 目前 有 多 少 Alarm 任务 存在 , 然后 将 触发 时 间 相近 的 几 个 任务 放 在 一 起 执行 , 这 
就 可 以 大 幅度 地 减少 CPU 被 唤醒 的 次 数 ， 从 而 有 效 延 长 电池 的 使 用 时 间 。 

当然 ， 如 果 你 要 求 Alarm 任务 的 执行 时 间 必 须 准 确 无 误 ，Android 仍然 提供 了 解决 方案 。 
使 用 AlarmManager 的 setExact () 方 法 来 替代 set () 方 法 ， 就 基本 上 可 以 保证 任务 能 够 准时 
执行 了 。 


13.5.2 ”Doze 模式 


虽然 Android 的 每 个 系统 版 本 都 在 手机 电量 方面 努力 进行 优化 , 不 过 一 直 没 能 解决 后 台 服 务 
泛滥 、 手 机 电量 消耗 过 快 的 问题 。 于 是 在 Android 6.0 系统 中 , 谷歌 加 入 了 一 个 全 新 的 Doze 模式 ， 
从 而 可 以 极 大 幅度 地 延长 电池 的 使 用 寿命 。 本 小 节 中 我 们 就 来 了 解 一 下 这 个 模式 , 并 且 掌 握 一 些 
编程 时 的 注意 事项 。 
首先 看 一 下 到 底 什 么 是 Doze 模式 。 当 用 户 的 设备 是 Android 6.0 或 以 上 系统 时 ， 如 果 该 设备 
未 插 接 电源 ， 处 于 静止 状态 ( Android 7.0 中 删除 了 这 一 条 件 )， 且 屏幕 关闭 了 一 段 时 间 之 后 ， 就 
会 进入 到 Doze 模式 。 在 Doze 模式 下 ， 系 统 会 对 CPU 、 网 络 、Alarm 等 活动 进行 限制 ， 从 而 延 
长 了 电池 的 使 用 寿命 。 

当然 , 系统 并 不 会 一 直 处 于 Doze 模式 , 而 是 会 间 敬 性 地 退出 Doze 模式 一 小 段 时 间 , 在 这 段 
时 间 中 ， 应 用 就 可 以 去 完成 它们 的 同步 操作 、Alarm 任务 ， 等 等 。 图 13.9 完整 描述 了 Doze 模式 
的 工作 过 程 。 
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未 插 电 源 短暂 退出 Doze 模 式 
设备 静止 
屏幕 关闭 


| 中 二 ee 


时 间 


图 13.9 ”Doze 模式 的 工作 过 程 


可 以 看 到 , 随 着 设备 进入 Doze 模式 的 时 间 越 长 , 间 吹 性 地 退出 Doze 模式 的 时 间 间 隔 也 会 越 
长 ,因为 如 果 设 备 长 时 间 不 使 用 的 话 , 是 没 必要 频繁 退出 Doze 模式 来 执行 同步 等 操作 的 ,Android 
在 这 些 细 节 上 的 把 控 使 得 电池 寿命 进一步 得 到 了 延长 。 

接 下 来 我 们 具体 看 一 看 在 Doze 模式 下 有 哪些 功能 会 受到 限制 吧 。 

口 网 络 访问 被 禁止 。 

口 系统 忽略 唤醒 CPU 或 者 屏幕 操作 。 

口 系统 不 再 执行 WIFI 扫描 。 

口 系统 不 再 执行 同步 服务 。 

口 Alarm 任务 将 会 在 下 次 退出 Doze 模式 的 时 候 执 行 。 

注意 其 中 的 最 后 一 条 ， 也 就 是 说 ， 在 Doze 模式 下 ， 我 们 的 Alarm 任务 将 会 变 得 不 准时 。 当 
然 ， 这 在 大 多 数 情况 下 都 是 合理 的 ， 因 为 只 有 当 用 户 长 时 间 不 使 用 手机 的 时 候 才 会 进入 Doze 模 
式 ， 通常 在 这 种 情况 下 对 Alarm 任务 的 准时 性 要 求 并 没有 那么 高 。 

不 过 , 如 果 你 真 的 有 非常 特殊 的 需求 , 要 求 Alarm 任务 即使 在 Doze 模式 下 也 必须 正常 执行 ， 
Android 还 是 提供 了 解决 方案 。 调 用 AlarmManager 的 setAndALLowWhiteIdtLe() 或 setExact- 
AndAllowWhileIdle() 方 法 就 能 让 定时 任务 即使 在 Doze 模式 下 也 能 正常 执行 了 , 这 两 个 方法 之 
间 的 区 别 和 set () 、setExact() 方 法 之 间 的 区 别 是 一 样 的 。 
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由 于 手机 屏幕 大 小 的 限制 ， 传 统 情况 下 一 个 手机 只 能 同时 打开 一 个 应 用 程序 ， 无 论 是 
Android 、iOS 还 是 Windows Phone 都 是 如 此 。 我们 也 早 就 对 此 习以为常 ， 认 为 这 是 理所当然 的 事 
情 。 而 Android 7.0 系统 中 却 引 入 了 一 个 非常 有 特色 的 功能 一 一 多 窗口 模式 ， 它 允许 我 们 在 同一 
个 屏幕 中 同时 打开 两 个 应 用 程序 。 对 于 手机 屏幕 越 来 越 大 的 今天 ， 这 个 功能 确实 是 越发 重要 了 ， 
那么 本 节 中 我 们 就 将 针对 这 一 主题 进行 学 习 。 
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13.6.1 进入 多 窗口 模式 

首先 你 需要 知道 , 我 们 不 用 编写 任何 额外 的 代码 来 让 应 用 程序 支持 多 窗口 模式 。 事实 上 , 本 
书 中 所 编写 的 所 有 项 目 都 是 支持 多 窗口 模式 的 。 但 是 这 并 不 意味 着 我 们 就 不 需要 对 多 窗口 模式 进 
行 学 习 ， 因 为 系统 化 地 了 解 这 些 知 识 点 才能 编写 出 在 多 窗口 模式 下 兼容 性 更 好 的 程序 。 

那么 先 来 看 一 下 如 何 才能 进入 到 多 窗口 模式 。 手 机 的 导航 栏 你 肯定 是 再 熟悉 不 过 了 ， 上 面 一 
共有 3 个 按钮 ， 如 图 13.10 所 示 。 


图 13.10 手机 导航 栏 
其 中 左边 的 Back 按钮 和 中 间 的 Home 按钮 我 们 都 经 常 使 用 , 但 是 右边 的 Overview 按钮 使 用 
得 就 比较 少 了 。 这 个 按钮 的 作用 是 打开 一 个 最 近 访 问 过 的 活动 或 任务 的 列表 界面 , 从 而 能 够 方便 
地 在 多 个 应 用 程序 之 间 进 行 切 换 ， 如 图 13.11 所 示 。 


图 13.11 Overview 列表 界面 
我 们 可 以 通过 以 下 两 种 方式 进入 多 窗口 模式 。 
口 在 Overview 列表 界面 长 按 任 意 一 个 活动 的 标题 ， 将 该 活动 拖 动 到 屏幕 突出 显示 的 区 域 ， 
则 可 以 进入 多 窗口 模式 。 
口 打开 任意 一 个 程序 ， 长 按 Overview 按钮 ， 也 可 以 进入 多 窗口 模式 。 
比如 说 我 们 首先 打开 了 MaterialTest 程序 ， 然 后 长 按 Overview 按钮 ， 效 果 如 图 13.12 所 示 。 
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图 13.12 进入 多 窗口 模式 


可 以 看 到 ， 现 在 整个 屏幕 被 分 成 了 上 下 两 个 部 分 ，MaterialTest 程序 占据 了 上 半 屏 ， 下 半 屏 
仍然 还 是 一 个 Overview 列表 界面 ， 另 外 Overview 按钮 的 样式 也 有 了 变化 。 现 在 我 们 可 以 从 


Overview 列表 中 选择 任意 一 个 其 他 程序 ， 比 如 说 这 里 点 击 LBSTest， 效 果 如 图 13.13 所 示 。 
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图 13.13 ”同时 打开 两 个 程序 
我 们 还 可 以 将 模拟 器 旋转 至 水 平方 向 , 这 样 上 下 分 屏 的 多 窗口 模式 会 自动 切换 成 左右 分 屏 的 
多 窗口 模式 ， 如 图 13.14 所 示 。 
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LBSTest 


图 13.14 左右 分 屏 的 多 窗口 模式 


多 窗口 模式 的 用 法 大 概 就 是 这 个 样子 了 , 我 们 可 以 将 任意 两 个 应 用 同时 打开 , 这 样 就 能 组 合 
出 许多 更 为 丰富 的 使 用 场景 。 比 如 说 刷 微 博 的 同时 还 能 时 刻 关注 QQ 群 消息 , 看 电影 的 同时 还 能 
和 别人 一 直 聊 着 微 信 ， 等 等 。 如 果 想 要 退出 多 窗口 模式 ， 只 需要 再 次 长 按 Overview 按钮 ， 或 者 
将 屏幕 中 央 的 分 隔 线 向 屏幕 任意 一 个 方向 拖 动 到 底 即 可 。 

可 以 看 出 , 在 多 窗口 模式 下 ,整个 应 用 的 界面 会 缩小 很 多 ,那么 编写 程序 时 就 应 该 多 考虑 使 
用 match parent 属性 、RecyclerView、ListView、ScrollView 等 控件 ， 来 让 应 用 的 界面 能 够 更 
好 地 适 配 各 种 不 同 尺 寸 的 屏幕 ， 尽 量 不 要 出 现 屏幕 尺寸 变化 过 大 时 界面 就 无 法 正常 显示 的 情况 。 
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接 下 来 我 们 学 习 一 下 多 窗口 模式 下 的 生命 周期 。 其 实 多 窗口 模式 并 不 会 改变 活动 原 有 的 生命 
周期 , 只 是 会 将 用 户 最 近 交 互 过 的 那个 活动 设置 为 运行 状态 , 而 将 多 窗口 模式 下 男 外 一 个 可 见 的 
活动 设置 为 暂停 状态 。 如 果 这 时 用 户 又 去 和 和 暂停 活动 进行 交互， 那么 该 活动 就 变 成 运行 状态 
之 前 处 于 运行 状态 的 活动 变 成 暂停 状态 。 


下 面 我 们 还 是 通过 一 个 例子 来 更 加 直观 地 理解 多 窗口 模式 下 活动 的 生命 周期 。 首 先 打开 
MaterialTest 项 目 ， 修 改 MainActivity 中 的 代码 ， 如 下 所 示 : 


public class MainActivity extends AppCompatActivity { 


private static final String TAG = "MaterialTest"; 


@Override 

protected void onCreate(Bundle savedInstanceState) { 
super.onCreate(savedInstanceState); 
Log.d(TAG, "onCreate"); 


} 


@Override 
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protected void onStart() { 
super.onStart(); 
Log.d(TAG, "onStart"); 
} 


@Override 

protected void onResume() { 
super.onResume(); 
Log.d(TAG, "onResume"); 

} 


@Override 

protected void onPause() { 
super.onPause(); 
Log.d(TAG, "onPause"); 

} 


@Override 

protected void onStop() { 
super.onStop(); 
Log.d(TAG, "onStop"); 

} 


@Override 

protected void onDestroy() { 
super.onDestroy(); 
Log.d(TAG, "onDestroy"); 

} 


@Override 
protected void onRestart() { 


super.onRestart(); 
Log.d(TAG, "onRestart"); 


} 
这 里 我 们 在 Activity 的 7 个 生命 周期 回调 方法 中 分 别 打印 了 一 句 日 志 。 
然后 点 击 Android Studio 导航 栏 上 的 File 一 Open Recent-*LBSTest， 重 新 打开 LBSTest 项 目 。 
修改 MainActivity 的 代码 ， 如 下 所 示 : 


public class MainActivity extends AppCompatActivity { 


private static final String TAG = "LBSTest"; 


@Override 

protected void onCreate(Bundle savedInstanceState) { 
super.onCreate(savedInstanceState); 
Log.d(TAG, "onCreate"); 
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@Override 

protected void onStart() { 
super.onStart(); 
Log.d(TAG, "onStart"); 

} 


@Override 

protected void onResume() { 
super.onResume(); 
Log.d(TAG, "onResume"); 
mapView.onResume(); 


} 


GOverride 

protected void onPause() { 
super.onPause(); 
Log.d(TAG, "onPause"); 
mapView.onPause(); 


} 


@Override 

protected void onStop() { 
super.onStop(); 
Log.d(TAG, "onStop"); 

} 


GOverride 

protected void onDestroy() { 
super.onDestroy(); 
Log.d(TAG, "onDestroy"); 
mLocationClient. stop(); 
mapView.onDestroy(); 
baiduMap.setMyLocationEnabled(false); 

} 


@Override 

protected void onRestart() { 
super.onRestart(); 
Log.d(TAG, "onRestart"); 


} 


这 里 同样 也 是 在 Activity 的 7 个 生命 周期 回调 方法 中 分 别 打 印 了 一 句 日 志 。 注 意 这 两 处 日 志 


的 TAG 是 不 一 样 的 ， 方便 我 们 进行 区 分 。 
现在 ， 先 将 MaterialTest 和 LBSTest 这 两 个 项 目的 最 新 代码 都 运行 


到 模拟 右上 ， 然 后 启动 


MaterialTest 程序 。 这 时 观察 logcat 中 的 打印 日 志 (注意 要 将 logcat 的 过 滤器 选择 为 No Filters )， 


如 图 13.15 所 示 。 


你 还 应 该 掌握 的 高 级 技巧 


Verbose | | G- Test 


com. example. materialtest D/MaterialTest: onCreate 


-dh 


com. example. materialtest D/MaterialTest: onStart 
com. example. materialtest D/MaterialTest: onResume 


图 13.15 ”启动 MaterialTest 时 的 打印 日 志 


可 以 看 到 ，onCreate() 、onStart() 和 onResume() 方 法 会 依次 得 到 执行 ， 这 个 也 是 在 我 们 
意料 之 中 的 。 然 后 长 按 Overview 按钮 ， 进 入 多 窗口 模式 ， 此 时 的 打印 信息 如 图 13.16 所 示 。 


| Verbose | -| (QTest ) 


com. example. materialtest D/MaterialTest: onPause 
com. example. materialtest D/MaterialTest: onStop 
com. example. materialtest D/MaterialTest: onDestroy 
com. example. materialtest D/MaterialTest: onCreate 
com. example. materialtest D/MaterialTest: onStart 
com. example. materialtest D/MaterialTest: onResume 


com. example. materialtest D/MaterialTest: onPause 


图 13.16 进入 多 窗口 模式 时 的 打印 日 志 


你 会 发 现 , MaterialTest 中 的 MainActivity 经 历 了 一 个 重新 创建 的 过 程 ,其 实 这 个 是 正常 现象 ， 
因为 进入 多 窗口 模式 后 活动 的 大 小 发 生 了 比较 大 的 变化 , 此 时 默认 是 会 重新 创建 活动 的 。 除 此 之 
外 ， 像 横竖 屏 切 换 也 是 会 重新 创建 活动 的 。 进 入 多 窗口 模式 后 ，MaterialTest 变 成 了 暂停 状态 。 


接着 在 Overview 列表 界面 选中 LBSTest 程序 ， 打 印信 息 如 图 13.17 所 示 。 


[Verbose | -| bs 3 


com. example. lbstest D/LBSTest: onCreate 
com. example. lbstest D/LBSTest: onStart 
com. example. lbstest D/LBSTest: onResume 


图 13.17 启动 LBSTest 时 的 打印 日 志 


可 以 看 到 ， 现 在 LBSTest 的 onCreate() 、onStart() 和 onResume() 方 法 依次 得 到 了 执行 ， 
说 明 现 在 LBSTest 变 成 了 运行 状态 。 


接 下 来 我 们 可 以 随意 操作 一 下 MaterialTest 程序 ， 然 后 观察 logcat 中 的 打印 日 志 ， 如 图 13.18 
所 示 。 


Verbose IQrTest: 
N 


com. example. lbstest D/LBSTest: onPause 


com. example. materialtest D/MaterialTest: onResume 


图 13.18 

现在 LBSTest 的 onPause() 方 法 得 到 了 执行 ， 而 MaterialTest 的 onResume() 方 法 得 到 了 执 
行 ， 说 明 LBSTest 变 成 了 暂停 状态 ，MaterialTest 则 变 成 了 运行 状态 ， 这 和 我 们 在 本 小 节 开 头 所 
分 析 的 生命 周期 行为 是 一 致 的 。 
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了 解 了 多 窗口 模式 下 活动 的 生命 周期 规则 , 那么 我 们 在 编写 程序 的 时 候 , 就 可 以 将 一 些 关 键 
性 的 点 考虑 进去 了 。 比 如 说 , 在 多 窗口 模式 下 ,用 户 仍 然 可 以 看 到 处 于 暂停 状态 的 应 用 , 那么 像 
视频 播放 器 之 类 的 应 用 在 此 时 就 应 该 能 继续 播放 视频 才 对 。 因 此 ， 我 们 最 好 不 要 在 活动 的 
onPause() 方 法 中 去 处 理 视 频 播 放 器 的 暂停 逮 辑 ， 而 是 应 该 在 onStop( ) 方 法 中 去 处 理 ， 并 且 在 
onStart () 方 法 恢复 视频 的 播放 。 

另外 ， 针 对 于 进入 多 窗口 模式 时 活动 会 被 重新 创建 ， 如 果 你 想 改变 这 一 默认 行为 ， 可 以 在 
AndroidManifest xml 中 对 活动 进行 如 下 配置 : 


<activity 
android:name=" .MainActivity" 
android:label="Fruits" 
android:configChanges="orientation |keyboardHidden |screenSize|screenLayout"> 
</activity> 
加 入 了 这 行 配置 之 后 ， 不 管 是 进入 多 窗口 模式 ， 还 是 横竖 屏 切换 ， 活 动 都 不 会 被 重新 创建 ， 
而 是 会 将 屏幕 发 生变 化 的 事件 通知 到 Activity 的 onConfigurationChanged() 方 法 当中 。 因 此 ， 
如 果 你 想 在 屏幕 发 生变 化 的 时 候 进行 相应 的 逻辑 处 理 ， 那 么 在 活动 中 重 写 onConfiguration- 
Changed () 方 法 即 可 。 


13.6.3 ”禁用 多 窗口 模式 

多 窗口 模式 虽然 功能 非常 强大 , 但 是 未 必 就 适用 于 所 有 的 程序 。 比 如 说 ,手机 游戏 就 非常 不 
适合 在 多 窗口 模式 下 运行 ， 很 难 想象 我 们 如 何 一 边 玩 着 游戏 ， 一边 又 操作 着 其 他 应 用 。 因 此 ， 
Android 还 是 给 我 们 提供 了 禁用 多 窗口 模式 的 选项 ， 如 果 你 非常 不 希望 自己 的 应 用 能 够 在 多 窗口 
模式 下 运行 ， 那么 就 可 以 将 这 个 功能 关闭 掉 。 

禁用 多 窗口 模式 的 方法 非常 简单 ， 只 需要 在 AndroidManifest.xml 的 <appLication> 或 
<activity> 标 签 中 加 入 如 下 属性 即 可 : 

android:resizeableActivity=["true" | "false"] 

其 中 ，true 表示 应 用 支持 多 窗口 模式 ，false 表示 应 用 不 支持 多 窗口 模式 ， 如 果 不 配置 这 
个 属性 ， 那 么 默认 值 为 true。 

现在 我 们 将 MaterialTest 程序 设置 为 不 支持 多 窗口 模式 ， 如 下 所 示 : 


<application 


android:resizeableActivity="false"> 
</application> 


重新 运行 程序 ， 然 后 长 按 Overview 按钮 ， 结 果 如 网 13.19 所 示 。 


图 13.19 不 支持 多 窗口 模式 时 长 按 Overview 按钮 


可 以 看 到 ， 现 在 是 无 法 进入 到 多 窗口 模式 的 ， 而 且 屏幕 下 方 还 会 弹出 一 个 Toast 提示 来 告知 


用 户 ， 当 前 应 用 不 支持 多 窗口 模式 。 


虽说 android:resizeableActivity 这 个 属性 的 用 法 很 简单 ， 但 是 它 还 存在 着 一 个 问题 ， 
就 是 这 个 属性 只 有 当 项 目的 targetSdkVersion 指定 成 24 或 者 更 高 的 时 候 才 会 有 用 ,否则 这 个 属性 


结果 如 图 13.20 所 示 。 


App may not work with split-screen. 


全 LBsTest 


图 13.20 targetSdkVersion 指定 成 23 时 长 按 Overview 按钮 


是 无 效 的 。 那么 比如 说 我 们 将 项 目的 targetSdkVersion 指定 成 23, 这 个 时 候 尝试 进入 多 窗口 模式 ， 
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可 以 看 到 ,虽说 界面 上 弹出 了 一 个 提示 ,告知 我 们 此 应 用 在 多 窗口 模式 下 可 能 无 法 正常 工作 ， 
但 还 是 进入 了 多 窗口 模式 。 那 这 样 我 们 就 非常 头疼 了 ， 因 为 有 很 多 的 老 项 目 ， 它们 的 
targetSdkVersion 都 没有 指定 到 24， 岂 不 是 这 些 老 项 目 都 无 法 禁用 多 窗口 模式 了 ? 

针对 这 种 情况 , 还 有 一 种 解决 方案 。Android 规定 , 如 果 项 目 指定 的 targetSdkVersion 低 于 24， 
并 且 活 动 是 不 允许 横竖 屏 切 换 的 ， 那 么 该 应 用 也 将 不 支持 多 窗口 模式 。 
默认 情况 下 , 我 们 的 应 用 都 是 可 以 随 着 手机 的 旋转 自由 地 横竖 屏 切 换 的 , 如 果 想 要 让 应 用 不 
允许 横竖 屏 切 换 ， 那 么 就 需要 在 AndroidManifest.xml 的 <activity> 标 签 中 加 入 如 下 配置 : 

android:screenOrientation=["portrait" | "landscape"] 

其 中 ，portrait 表示 活动 只 支持 竖 屏 ，Landscape 表示 活动 只 支持 横 屏 。 当 然 android: 
screen0rientation 属性 中 还 有 很 多 其 他 可 选 值 , 不 过 最 常用 的 就 是 portrait 和 Tlandscape 了 。 

现在 我 们 将 MaterialTest 的 MainActivity 设置 为 只 支持 竖 屏 ， 如 下 所 示 

<activity 

android:name=" .MainActivity" 


android:label="Fruits" 
android:screenOrientation="portrait"> 


</activity> 
重新 运行 程序 之 后 你 会 发 现 MaterialTest 现在 不 支持 横竖 屏 切换 了 , 此 时 长 按 Overview 按钮 
会 弹出 和 图 13.19 中 一 样 的 提示 ， 说 明 我 们 已 经 成 功 禁 用 多 窗口 模式 了 。 


13.7 Lambda 表达 式 


Java 8 中 着 实 引 入 了 一 些 非 常 有 特色 的 功能 ， 如 Lambda 表达 式 、stream API、 接 口 默 认 实 现 ， 
等 等 。 虽 说 我 们 本 地 安装 的 JDK 就 是 Java 8 的 版 本 ， 不 过 本 书 中 却 一 直 没 有 使 用 过 任何 Java 8 的 
新 特性 。 这 主要 是 因为 我 考虑 到 你 对 Java 8 的 新 语法 规则 可 能 并 不 熟悉 , 如 果 直 接应 用 到 项 目 中 的 
话 ， 容 易 让 代码 难以 理解 ， 因 此 这 里 我 就 准备 单独 使 用 一 节 的 篇 幅 来 对 Java 8 的 新 特性 进行 讲解 。 

虽然 刚才 已 经 提 到 了 几 个 Java 8 中 的 新 特性 , 不 过 现在 能 够 立即 应 用 到 项 目 当 中 的 也 就 只 有 
Lambda 表达 式 而 已 ,因为 stream API 和 接口 默认 实现 等 特性 都 只 支持 Android 7.0 及 以 上 的 系统 ， 
我 们 显然 不 可 能 为 了 使 用 这 些 新 特性 而 放弃 兼容 众多 低 版 本 的 Android 手机 。 而 Lambda 表达 式 
却 最 低 兼容 到 Android 2.3 系统 , 基本 上 可 以 算是 覆盖 所 有 的 Android 手机 了 , 那么 本 节 中 我 们 就 
来 重点 学 习 一 下 Java 8 中 的 Lambda 表达 式 。 

Lambda 表达 式 本 质 上 是 一 种 匿名 方法 ， 它 既 没有 方法 名 ， 也 即 没有 访问 修饰 符 和 返回 值 类 
型 ， 使 用 它 来 编写 代码 将 会 更 加 简洁 ， 也 更 加 易 读 。 

如 果 想 要 在 Android 项 目 中 使 用 Lambda 表达 式 或 者 Java 8 的 其 他 新 特性 ， 首 先 我 们 需要 在 
app/build.gradle 中 添加 如 下 配置 : 
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android { 
defaultConfig { 
jackOptions .enabLed = true 


compileOptions { 
sourceCompatibility JavaVersion.VERSION 1 8 
targetCompatibility JavaVersion.VERSION 1 8 


} 


之 后 就 可 以 开始 使 用 Lambda 表达 式 来 编写 代码 了 ， 比 如 说 传统 情况 下 开启 一 个 子 线 程 的 写 
法 如 下 : 


new Thread(new Runnable() { 
@Override 
public void run() { 
// 处 理 具体 的 逻辑 


} 
}).start(); 


而 使 用 Lambda 表达 式 则 可 以 这 样 写 
new Thread(() -> { 

// 处 理 具体 的 还 辑 
}).start(); 
是 不 是 很 神奇 ? 不 管 是 从 代码 行 数 上 还 是 缩 进 结构 上 来 看 ，Lambda 表达 式 的 写法 明显 要 更 
加 精简 。 

那么 为 什么 我 们 可 以 使 用 这 么 神奇 的 写法 呢 ? 这 是 因为 Thread 类 的 构造 函数 接收 的 参数 是 
一 个 Runnable 接口 , 并 且 该 接口 中 只 有 一 个 待 实现 方法 。 我 们 查看 一 下 Runnable 接口 的 源码 ， 
如 下 所 示 : 


public interface Runnable { 


ys 


/** 
* Starts executing the active part of the class' code. This method is 
* called when a thread is started that has been created with a class which 
* implements {@code Runnable}. 
*/ 
public void run(); 
} 


凡是 这 种 只 有 一 个 待 实现 方法 的 接口 ， 都 可 以 使 用 Lambda 表达 式 的 写法 。 比 如 说 ， 通常 创 
建 一 个 类 似 于 上 述 接口 的 匿名 类 实现 需要 这 样 写 : 


Runnable runnable = new Runnable() { 
@Override 
public void run() { 
// 添加 有 具体 的 实现 
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} 
}; 


而 有 了 Lambda 表达 式 之 后 我 们 就 可 以 这 样 写 了 : 
Runnable runnablel = () -> { 
// 添加 具体 的 实现 
了 解 了 Lambda 表达 式 的 基本 写法 ， 接 下 来 我 们 尝试 自 定义 一 个 接口 ， 然 后 再 使 用 Lambda 
表达 式 的 方式 进行 实现 。 
新 建 一 个 MyListener 接口 ， 代 码 如 下 所 示 : 


public interface MyListener { 


String doSomething(String a, int b); 

} 

MyListener 接口 中 也 只 有 一 个 待 实现 方法 ， 这 和 Runnable 接口 的 结构 是 基本 一 致 的 。 唯 一 
不 同 的 是 , MyListener 中 的 doSomething ( ) 方 法 是 有 参数 并 且 有 返回 值 的 , 那么 我 们 就 来 看 一 看 
这 种 情况 下 该 如 何 使 用 Lambda 表达 式 进 行 实现 。 

其 实 写法 也 是 比较 相似 的 ,使 用 Lambda 表达 式 创建 MyListener 接口 的 匿名 实现 写法 如 下 : 


MyListener listener = (String a, int b) -> { 
String result =a + b; 
return result; 


}; 


可 以 看 到 , doSomething () 方 法 的 参数 直接 写 在 括号 里 面 就 可 以 了 , 而 返回 值 则 仍然 像 往 常 
一 样 ， 写 在 具体 实现 的 最 后 一 行 即 可 。 

另外 ，Java 还 可 以 根据 上 下 文 自 动 推断 出 Lambda 表达 式 中 的 参数 类 型 ， 因 此 上 面 的 代码 也 
可 以 简化 成 如 下 写法 : 

MyListener listener 


String result 
return result; 


a, b) -> 1{ 


三 ( La 
a+b; 
}; 


Java 将 会 自动 推断 出 参数 a 是 String 类 型 , 参数 b 是 int 类 型 ， 从 而 使 得 我 们 的 代码 变 得 
更 加 精简 了 。 
接 下 来 举 个 具体 的 例子 ， 比 如 说 现在 有 一 个 方法 是 接收 MyListener 参数 的 ， 如 下 所 示 : 


public void heLLo(MyListener Listener) { 
String a = "Hello Lambda"; 
int b = 1024; 
String result = listener.doSomething(a, b); 
Log.d("TAG", result); 


We 
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我 们 在 调用 hello() 这 个 方法 的 时 候 就 可 以 这 样 写 : 
hello((a, b) -> { 
String result =a + b; 
return result; 
}); 
那么 dosomething () 方 法 就 会 将 a 和 b 两 个 参数 进行 相 加 ， 从 而 最 终 的 打印 结果 就 会 是 
“Hello Lambdal024”。 


现在 你 已 经 将 Lambda 表达 式 的 写法 基本 都 掌握 了 ， 接 下 来 我 们 看 一 看 在 Android 当中 有 哪 
些 常用 的 功能 是 可 以 使 用 Lambda 表达 式 进 行 替 换 的 。 


其 实 只 要 是 符合 接口 中 只 有 一 个 待 实现 方法 这 个 规则 的 功能 ， 都 是 可 以 使 用 Lambda 表达 式 


来 编写 的 。 除 了 刚才 举例 说 明 的 开启 子 线程 之 外 , 还 有 像 设置 点 击 事件 之 类 的 功能 也 是 非常 适合 
使 用 Lambda 表达 式 的 。 


传统 情况 下 ， 我 们 给 一 个 按钮 设置 点 击 事件 需要 这 样 写 : 


Button button = (Button) findViewById(R.id.button); 
button.setOnClickListener(new View.0nCLickListener() { 
@Override 
public void onClick(View v) { 
// 处 理 点 击 事件 


} 
}); 


而 使 用 Lambda 表达 式 之 后 ， 就 可 以 将 代码 简化 成 这 个 样子 了 : 


Button button = (Button) findViewById(R.id.button); 
button.setOnClickListener((v) -> { 

// 处 理 点 击 事件 
}); 


另外 ， 当 接口 的 待 实现 方 法 有 且 只 有 一 个 参数 的 时 候 , 我 们 还 可 以 进一步 简化 , 将 参数 外 面 
的 插 号 去 掉 ， 如 下 所 示 : 

Button button = (Button) findViewById(R.id.button); 

button.setOnClickListener(v -> { 

// 处 理 点 击 事件 

}); 

这 样 我 们 就 将 Lambda 表达 式 的 主要 内 容 都 掌握 了 。 当 然 ， 有 些 人 可 能 并 不 喜欢 Lambda 表 
达 式 这 种 极 简 主义 的 写法 。 不 管 你 喜欢 与 否 ，Java 8 对 于 哪 一 种 写法 都 是 完全 支持 的 ， 至 于 到 底 
要 不 要 使 用 Lambda 表达 式 其 实 全 赁 个 人 ， 多 一 种 选择 总 归 不 是 一 件 坏事 情 。 


13.8 总 结 


整整 13 章 的 内 容 你 已 经 全 部 学 完了 ! 本 书 的 所 有 知识 点 也 到 此 结束 ， 是 不 是 感觉 有 些 激动 
呢 ? 下 面 就 让 我 们 来 回顾 和 总 结 一 下 这 么 久 以 来 学 过 的 所 有 东西 吧 。 

这 13 章 的 内 容 不 算 很 多 ,但 却 已 经 把 Android 中 绝 大 部 分 比较 重要 的 知识 点 都 覆盖 到 了 。 
我 们 从 搭建 开发 环境 开始 学 起 , 后 面 逐 步 学 习 了 四 大 组 件 、UI、 碎片 、 数 据 存储 、 多 媒体 、 网 络 、 
定位 服务 、Material Design 等 内 容 ， 本 章 中 又 学 习 了 如 全 局 获取 Context、 定 制 日 志 工 具 、 调 试 程 
序 、 多 窗口 模式 编程 、Lambda 表达 式 等 高 级 技巧 ,相信 你 已 经 从 一 名 初学 者 赔 变 成 一 位 Android 
开发 好 手 了 。 

不 过 , 虽然 你 已 经 储备 了 足够 多 的 知识 , 并 掌握 了 很 多 的 最 佳 实践 技巧 ,但 是 你 还 从 来 没有 
真正 开发 过 一 个 完整 的 项 目 , 也 许 在 将 所 有 学 到 的 知识 混合 到 一 起 使 用 的 时 候 , 你 会 感到 有 些 手 
足 无 措 。 因 此 ， 前 进 的 脚步 仍然 不 能 停 下 ， 下 一 章 中 我 们 会 结合 前 面 章节 所 学 的 内 容 ,一 起 开发 
一 个 天 气 预 报 程序 。 锻 炼 的 机 会 可 千 万 不 能 错过 ， 赶 快 进入 到 下 一 章 吧 。 


~ 
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我 们 将 要 在 本 章 中 编写 一 个 功能 较为 完整 的 天 气 预报 程序 ， 学 习 了 这 人 么 久 的 Android 开发 ， 
现在 终于 到 了 考核 验收 的 时 候 了 。 那么 第 一 步 我 们 需要 给 这 个 软件 起 个 好 听 的 名 字 , 这 里 就 叫 它 
酷 欧 天 气 吧 ， 英 文 名 就 叫 作 Cool Weather。 确 定 了 名 字 之 后 ， 下 面 就 可 以 开始 动手 了 。 


14.1 ”功能 需求 及 技术 可 行 性 分 析 
在 开始 编码 之 前 ， 我 们 需要 先 对 程序 进行 需求 分 析 ， 想 一 想 酷 欧 天 气 中 应 该 具备 哪些 功能 。 
将 这 些 功能 全 部 整理 出 来 之 后 , 我 们 才 好 动手 去 一 一 实现 。 这 里 我 认为 酷 欧 天 气 中 至 少 应 该 具备 
以 下 功能 : 
口 可 以 罗列 出 全 国 所 有 的 省 、 市 、 县 ; 
口 可 以 查看 全 国 任意 城市 的 天 气 信 息 ; 
口 可 以 自由 地 切换 城市 ， 去 查看 其 他 城市 的 天 气 ; 
口 提供 手动 更 新 以 及 后 台 自 动 更 新 天 气 的 功能 。 


虽然 看 上 去 只 有 4 个 主要 的 功能 点 ， 但 如 果 想 要 全 部 实现 这 些 功 能 却 需要 用 到 UI、 网 络 、 
数据 存储 、 服 务 等 技术 ,因此 还 是 非常 考验 你 的 综合 应 用 能 力 的 。 不 过 好 在 这 些 技术 在 前 面 的 章 
节 中 我 们 全 部 都 学 习 过 了 ， 只 要 你 学 得 用 心 ， 相 信 完 成 这 些 功能 对 你 来 说 并 不 难 。 

分 析 完 了 需求 之 后 ， 接 下 来 就 要 进行 技术 可 行 性 分 析 了 。 首 先 需 要 考虑 的 一 个 问题 就 是 , 我 
们 如 何 才能 得 到 全 国 省 市 县 的 数据 信息 , 以 及 如 何 才 能 获取 到 每 个 城市 的 天 气 信息 。 比 较 遗 憾 的 
是 , 现在 网 上 免费 的 天 气 预 报 接口 已 经 越 来 越 少 , 很 多 之 前 可 以 使 用 的 接口 都 慢 慢 关闭 掉 了 , 包 
括 本 书 第 1 版 中 使 用 的 中 国 天 气 网 的 接口 。 因 此 , 这 次 我 也 是 特意 用 心 去 找 了 一 些 更 加 稳定 的 天 
气 预报 服务 ， 比 如 彩云 天 气 以 及 和 风 天 气 都 非常 不 错 。 这 两 个 天 气 预报 服务 虽说 都 是 收费 的 , 但 
它们 每 天 都 提供 了 一 定 次 数 的 免费 天 气 预报 请 求 。 其 中 彩云 天 气 的 数据 更 加 实时 和 专业 , 可 以 将 
天 气 预报 精确 到 分 钟 级 ， 每 天 提供 1000 次 免费 请 求 ; 和 风 天 气 的 数据 相对 简单 一 些 ， 比 较 适 合 
新 手 学 习 ， 每 天 提供 3000 次 免费 请 求 。 那 么 简单 起 见 ， 这 里 我 们 就 使 用 和 风 天 气 来 作为 天 气 预 
报 的 数据 来 源 ， 每 天 3000 次 的 免费 请 求 对 于 学 习 而 言 已 经 是 相当 充足 了 。 
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解决 了 天 气 数据 的 问题 , 接 下 来 还 需要 解决 全 国 省 市 县 数据 的 问题 。 同 样 ,现在 网 上 
一 个 稳定 的 接口 可 以 使 用 , 那么 为 了 方便 你 的 学 习 , 我 专门 架设 了 一 台 服 务 器 用 于 提供 全 
省 市 县 的 数据 信息 ， 从 而 帮 你 把 道路 都 铺 平 了 。 

那么 下 面 我 们 来 看 一 下 这 些 接口 的 具体 用 法 。 比 如 要 想 罗 列 出 中 国 所 有 的 省 份 ,只 需 访 
下 地 址 : 

http://guolin.tech/api/china 


也 没 有 
国 所 有 


问 如 


服务 器 会 返回 我 们 一 段 JSON 格式 的 数据 ， 其 中 包含 了 中 国 所 有 的 省 份 名 称 以 及 省 份 jd， 如 
下 所 示 : 

[{"id" "name" ne ne 大 

{"id" a “namen "重庆 "},{"id":5,"name":" 香 港 "},{"id":6，, ee 

{"id":7,"name":" 人 台湾"},{"id":8,"name":" 黑 龙 江 "},{"id" :9 ee “吉林 }, 

Td 1 nm {"id" 11, rnamewi' 兴 莹 二 },{"id" "name": "河北 "}， 

{"id":13,"name":" 河 南 "},{"id":14,"name":" "id" a es 人 } 

{"id":16, "name": "江苏"},{"id":17,"name": "浙江"},{"id":18,"name": "福建 "}， 

{"id":19, "name": "江西 "},{"id":20, "name":" "id":21, "name": "湖北 "}， 

{"id":22, "name": "湖南 "},{"id":23, "name":" "id":24, "name":" 广 西 "}， 

{"id":25,"name":" 海 南 "},{"id":26,"name":" "id":27,"name":" 云 南 "}， 

{"id":28,"name": "四川 "},{"id":29,"name":" "id":30,"name":" 陕 西 "}， 

{"id":31,"name":" 宁 夏 "},{"id":32,"name":" "id":33,"name":" 青 海 "}， 

{"id":34,"name":" 新 疆 "}] 

可 以 看 到 ， 这 是 一 个 JSON 数组 ,数组 中 的 每 一 个 元 素 都 代表 着 一 个 省 份 。 其中， 北京 的 id 


是 1， 上 海 的 id 是 2。 那 么 如 何 才 能 知道 某 个 省 内 有 哪些 城市 呢 ?” 其 实 也 很 简单 ， 比 如 江苏 的 id 
是 16, 访问 如 下 地 址 即 可 : 
http://guolin.tech/api/china/16 


也 就 是 说 , 只 需要 将 省 份 id 添加 到 url 地 址 的 最 后 面 就 可 以 了 , 现在 服务 需 返 回 的 数据 如 下 : 


[{"id":113, "name":" 南 京 "},{"id":114,"name": "无锡 "fid":115,"name": "镇 江 "]}， 
{"id":116," ‘name" :苏州 "},{"id":117, "name": "南通"},{"id":118, "name": "扬州 "}， 
{"id":119,"name": "盐城 "},{"id":120,"name": "徐州"},{"id":121,"name":" 淮 安 "}， 
{"id":122,"name":" 连 云 港 "},{"id":123,"name":" 常 州 "},{"id":124,"name":" 泰 州 "}， 
{"id":125,"name":" 宿 迁 "}] 


这 样 我 们 就 得 到 江苏 省 内 所 有 城市 的 信息 了 , 可 以 看 到 , 现在 返回 的 数据 格式 和 刚才 查看 省 
份 信息 时 返回 的 数据 格式 是 一 样 的。 相信 此 时 你 已 经 可 以 举一反三 了 ， 比 如 说 苏州 的 id 是 116， 
那么 想 要 知道 苏州 市 下 又 有 哪些 县 和 区 的 时 候 ， 只 需 访 问 如 下 地 址 : 
http://guolin.tech/api/china/16/116 


这 次 服务 器 返回 的 数据 如 下 : 

[{"id":937,"name":" 苏 州 ", "weather_id":"CN101190401"}， 
{"id":938," name";" 常 热 "， weather Id":"CN191190402"}， 
{"id":939,"name":" 张 家 港 ", "weather_id":"CN101190403"}， 
{"id":940,"name":" 昆 山 ", "weather id":"CN101190404"}, 
{"id":941,"name":" 吴 中 ", "weather_id":"CN101190405"}，, 
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{"id":942,"name":" 吴 江 ", "weather id":"CN101190407"}， 

{"id":943,"name":" 大 仓 ", "weather id":"CN101190408"}] 

通过 这 各 方式， 我们 就 能 把 全 国 所 有 的 省 、 市 、 县 都 罗列 出 来 了 。 那 么 解决 了 省 市 县 数据 的 
获取 ,我们 又 怎样 才能 查看 到 具体 的 天 气 信息 呢 ? 这 就 必须 要 用 到 每 个 地 区 对 应 的 天 气 id 了 。 
观察 上 面 返回 的 数据 ,你 会 发 现 每 个 县 或 区 都 会 有 一 个 weather_id, 拿 着 这 个 id 再 去 访问 和 风 天 
气 的 接口 ， 就 能 够 获取 到 该 地 区 具体 的 天 气 信息 了 。 

下 面 我 们 来 看 一 下 和 风 天 气 的 接口 该 如 何 使 用 。 首先 你 需要 注册 一 个 自己 的 账号 , 注册 地 址 
是 http://guolin.tech/api/weather/register。 注 册 好 了 之 后 使 用 这 个 账号 登录 ， 就 能 看 到 自己 的 API 
Key， 以 及 每 天 剩余 的 访问 次 数 了 ， 如 图 14.1 所 示 。 


4 API 接 口 我 的 产品 计划 : 免费 用 户 购买 ”有效 期 : 永久 
个 人 认证 key : bc0418b57b2d4918819d3974ac 1285d9 
免费 用 户 剩余 每 天 访问 流量 : 3000 次 


图 14.1 APIKey 和 每 天 剩余 访问 次 数 
有 了 API Key， 再 配合 刚才 的 weather id， 我 们 就 能 获取 到 任意 城市 的 天 气 信 息 了 。 比 如 说 
苏州 的 weather id 是 CN101190401， 那 么 访问 如 下 接口 即 可 查看 苏州 的 天 气 信息 : 


http://guolin.tech/api/weather?cityid=CN101190401&key=bc0418b57b2d4918819d3974ac12 
85d9 


其 中 ，cityid 部 分 填 和 人 的 就 是 待 查看 城市 的 weather id，key 部 分 填 人 的 就 是 我 们 申请 到 的 
API Key。 这 样 ， 服 务 器 就 会 把 苏州 详细 的 天 气 信息 以 JSON 格式 返回 给 我 们 了 。 不 过 ， 由 于 返 
回 的 数据 过 于 复杂 ， 这 里 我 做 了 一 下 精简 处 理 ， 如 下 所 示 : 

{ 


"HeWeather": [ 

{ 
"status": "ok", 
"basic": {}, 
"aqi": {}, 
"now": {}, 
"suggestion": {}, 
"daily forecast": [] 


] 
} 


返回 数据 的 格式 大 体 上 就 是 这 个 样子 了 , 其 中 status 代表 请 求 的 状态 , ok 表示 成 功 basic 
中 会 包含 城市 的 一 些 基 本 信息 ，aqi 中 会 包含 当前 空气 质量 的 情况 ，now 中 会 包含 当前 的 天 气 信 
息 ，suggestion 中 会 包含 一 些 天 气相 关 的 生活 建议 , daily_forecast 中 会 包含 未 来 几 天 的 天 气 
言 息 。 访 问 http://guolin.tech/api/weather/doc 这 个 网 址 可 以 查看 更 加 详细 的 文档 说 明 。 

数据 都 能 获取 到 了 之 后 ， 接 下 来 就 是 JSON 解析 的 工作 了 ， 这 对 于 你 来 说 应 该 很 轻松 了 吧 ? 

确定 了 技术 完全 可 行 之 后 ， 接 下 来 就 可 以 开始 编码 了 。 不 过 别 着 急 ， 我 们 准备 让 酶 欧 天 气 成 
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为 一 个 开源 软件 , 并 使 用 GitHub 来 进行 代码 托管 , 因此 先 让 我 们 进入 到 本 书 最 后 一 次 的 Git 时 间 。 
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将 代码 托管 到 GitHub 上 


经 过 前 面 几 章 的 学 习 ， 相 信 你 已 经 可 以 非常 熟练 地 使 用 Git 了 。 本 节 依 然 是 Git 时 间 ， 这 次 
我 们 将 会 把 酷 欧 天 气 的 代码 托管 到 GitHub 上 面 。 


GitHub 是 全 球 最 大 的 代码 托管 网 站 ,主要 是 借助 Git 来 进行 版 本 控制 的 。 任何 开 源 软 件 都 可 


以 免费 地 将 代码 提交 到 GitHub 上 ， 以 零 成 本 的 代价 进行 代码 托管 。GitHub 的 官网 地 址 是 
网 的 首页 如 图 14.2 所 示 。 


https://github.com/。 


Mowipeople 
oolson sl 


图 14.2” GitHub 首页 


首先 你 需要 有 一 个 GitHub 账号 才能 使 用 GitHub 的 代码 托管 功能 ， 点 击 Sign up for GitHub 
按钮 进行 注册 ， 然 后 填 入 用 户 名 、 邮 箱 和 和 密码， 如 图 14.3 所 示 。 


Create your personal account 
Username 

guolindev Vv 
This will be your usermame 一 you can enter your organization's username next 
Email Address 


sinyu890807@163.com Vv 


By clicking on "Create an account” below, you are agreeing to the Terms 
of Service and the Privacy Policy. 


图 14.3 ”注册 账号 
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点 击 Create an account 按钮 来 创建 账户 ， 接 下 来 会 让 你 选择 个 人 计划 ， 收 费 计 划 有 创建 私 
人 版 本 库 的 权限 ， 而 我 们 的 酷 欧 天 气 是 开源 软件 ， 所 以 这 里 选择 免费 计划 就 可 以 了 ， 如 图 14.4 
所 示 。 


Choose your personal plan 
由 Unlimited public repositories for free. 
Unlimited private repositories for $7/month. (view in CNY) 
Don't worry, you can cancel or upgrade at any time. 


可 Help me set up an organization next 
Organizations are separate from personal accounts and are best suited for 
businesses who need to manage permissions for many employees. 


Learn more about organizations. 


Continue 


图 14.4 ”选择 免费 计划 
接着 点 击 Continue 按钮 会 进入 一 个 问卷 调查 界面 ， 如 图 14.5 所 示 。 


How would you describe your level of programming experience? 


© Totally new to programming @ Somewhat experienced @ Very experienced 


What do you plan to use GitHub for? (check all that apply) 


国 School projects 国 Research 国 Design 


国 Development 国 Project Management 国 Other (please specify) 


Which is closest to how you would describe yourself? 
Tm a hobbyist 9 Tm a professional Tm a student 


Other (please specify) 


What are you interested in? 


e.g. tutorials, android, ruby, web-development machine-leaming, open-source 


skip this step 
图 14.5 问卷 调查 界面 
如 果 你 对 这 个 有 兴趣 就 填写 一 下 , 没 兴趣 的 话 直 接点 击 最 下 方 的 skip this step 跳 过 就 可 以 了 。 
这 样 我 们 就 把 账号 注册 好 了 ， 会 自动 跳 转 到 GitHub 的 个 人 主页 ， 如 图 14.6 所 示 。 
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© Pullrequests Issues Gist 十 ~ 中 = 


Learn Git and GitHub without any code! 


Using the Hello World guide, you'll create a repository start a branch, 
write comments, and open a pull request 


Start a project 


图 14.6 GitHub 个 人 主页 


接 下 来 就 可 以 点 击 Startaproject 按钮 来 创建 一 个 版 本 库 了 。 由 于 我 们 是 刚刚 注册 的 账号 , 在 


创建 版 本 库 之 前 还 需要 做 一 下 邮箱 验证 ， 验 证 成 功 之 后 就 和 
coolweather， 然 后 选择 添加 一 个 Android 项 目 类 


开始 创建 了 。 这 里 将 版 本 库 命 名 为 


类 型 的 .gitignore 文件 ， 并 使 用 Apache License 2.0 


来 作为 酷 欧 天 气 的 开源 协议 ， 如 图 14.7 所 示 。 


Owner Repository name 
We guolindev ~ / coolweather Vv 
Great repository names are short and memorable. Need inspiration? How about glowing-octo-adventure. 


Description (optional) 


. Public 


Anyone can see this repository. You choose who can commit, 
Private 
You choose who can see and commit to this repository 

回 Initialize this repository with a README 


This will let you immediately clone the repository to your computer. Skip this step if you're importing an existing repository. 


Add .gitignore: Android ~ Add a license: Apache License 2.0 ~ 


图 14.7 创建 版 本 库 


接着 点 击 Create repository 按钮 ，coolweather 这 个 版 本 | 
本 库 主页 地 址 是 https://github.com/guolindev/coolweather。 


D 1commit bp 1branch OO releases 


Branchs master ”New pull request 


We guolindev Initial commit 


目 1 commit 
国 UCENSE nitial commit 
国 READMEmd nitial commit a minute ago 
README.md 
coolweather 


图 14.8 ”版 本 库 主 页 


亩 就 创建 完成 了 ， 如 图 14.8 所 示 。 版 
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可 以 看 到 , GitHub 已 经 自动 帮 我 们 创建 了 .gitignore、LICENSE 和 README.md 这 3 个 文件 ， 
其 中 编辑 README.md 文件 中 的 内 容 可 以 修改 酶 欧 天 气 版 本 库 主 页 的 描述 。 

创建 好 了 版 本 库 之 后 ， 我 们 就 需要 创建 酷 欧 天 气 这 个 项 目 了 。 在 Android Studio 中 新 建 一 个 
Android 项目， 项 目 名 叫 作 CoolWeather， 包 名 叫 作 com.coolweather.android， 如 图 14.9 所 示 。 


px New Project 


Android Studio 


Configure your new project 


Application name: | CoolWeather 


Company Domain: | example.com 


Package name: 。 | com.coolweather.android 


口 ndude C++ Support 


Project location: 。 | ENsourcevchapter3\CoolWeather | 


[ED WE Eee [到 


图 14.9 创建 CoolWeather 项 目 
之 后 的 步 又 不 用 多 说 ,一直 点 击 Next 就 可 以 完成 项 目的 创建 ,所 有 选项 都 使 用 默认 的 就 好 。 


接 下 来 的 一 步 非常 重要 ， 我 们 需要 将 远程 版 本 库 克 隆 到 本 地 。 首 先 必须 知道 远程 版 本 库 的 
Git 地 址 ， 点 击 Clone or download 按钮 就 能 够 看 到 了 ， 如 图 14.10 所 示 。 


:newfile Uploadfiles Find file Clone or download ~ 


Clone with HTTPS @ Use SSH 
Use Git or checkout with SVN using the web URL. 


https://github.com/guolindev/coolweather.g 良 
Open in Desktop Download ZIP 


图 14.10 查看 版 本 库 的 Git 地 址 


点 击 右边 的 复制 按钮 可 以 将 版 本 库 的 Git 地 址 复制 到 剪贴 板 ， 酷 欧 天 气 版 本 库 的 Git 地 址 是 
https://github.com/guolindev/coolweather.git。 


然后 打开 Git Bash 并 切换 到 CoolWeather 的 工程 目录 下 ， 如 图 14.11 所 示 。 
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图 14.11 在 Git Bash 中 进入 CoolWeather 工程 目录 


接着 输入 git clone https://github.com/guolindev/coolweather.git 来 把 远程 版 本 库 克 隆 到 本 地 ， 
如 图 14.12 所 示 。 


图 14.12 ”将 远程 版 本 库 克隆 到 本 地 


看 到 图 中 所 给 的 文字 提示 就 表示 克隆 成 功 了 , 并 是 .gitignore、LICENSE 和 README.md 这 3 
个 文件 也 已 经 被 复制 到 了 本 地 ， 可 以 进入 到 coolweather 目录 ， 并 使 用 1Ls -at 命令 查看 一 下 ， 如 
图 14.13 所 示 。 


图 14.13 查看 克隆 到 本 地 的 文件 


现在 我 们 需要 将 这 个 目录 中 的 所 有 文件 全 部 复制 粘贴 到 上 一 层 目录 中 ， 这 样 就 能 将 整个 
CoolWeather 工程 目录 添加 到 版 本 控制 中 去 了 。 注意 .git 是 一 个 隐藏 目录 , 在 复制 的 时 候 千 万 不 要 
漏 掉 。 另 外 ， 上 一 层 目录 中 也 有 一 个 .gitignore 文件 ,我 们 直接 将 其 覆盖 即 可 。 复 制 完 之 后 可 以 把 
coolweather 目录 删除 掉 ， 最 终 CoolWeather 工程 的 目录 结构 如 图 14.14 所 示 。 


图 14.14 ”CoolWeather 工程 的 目录 结构 
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接 下 来 我 们 应 该 把 CoolWeather 项 目 中 现 有 的 文件 提交 到 GitHub 上 面 , 这 就 很 简单 了 , 先 将 
所 有 文件 添加 到 版 本 控制 中 ， 如 下 所 示 : 


git add . 

然后 在 本 地 执行 提交 操作 : 

git commit -m "First commit." 

最 后 将 提交 的 内 容 同 步 到 远程 版 本 库 ， 也 就 是 GitHub 上 面 : 
git push origin master 


注意 ， 在 最 后 一 步 的 时 候 GitHub 要 求 输入 用 户 名 和 密码 来 进行 身份 校 验 ， 这 里 输入 我 们 注 
册 时 填 入 的 用 户 名 和 密码 就 可 以 了 ， 如 图 14.15 所 示 。 


图 14.15 将 提交 的 内 容 同 步 到 远程 版 本 库 


这 样 就 已 经 同步 完成 了 , 现在 刷新 一 下 酷 欧 天 气 版 本 库 的 主页 ， 你 会 看 到 刚才 提交 的 那些 文 
件 已 经 存在 了 ， 如 图 14.16 所 示 。 


1 tinnuharo1971 First commit. Latest commit 8b32138 6 minutes ago 
idea First commit. 
app First comm 


First cor 


I 
I 
I 
F 
adle.properties First commit 
- 
F 
F 


图 14.16 在 GitHub 上 查看 提交 的 内 容 
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从 本 节 开 始 ， 我 们 就 要 真正 地 动手 编码 了 ， 为 了 要 让 项 目 能 够 有 更 好 的 结构 ， 这 里 需要 在 
com.coolweatherandroid 包 下 再 新 建 几 个 包 ， 如 图 14.17 所 示 。 


14.3 ”创建 数据 库 和 表 495 


疡 java 
加 com.coolweatherandroid 
所 db 
加 gson 
加 service 
后 util 
TH MainActivity 


图 14.17 项 目的 新 结构 


其 中 db 包 用 于 存放 数据 库 模 型 相关 的 代码 , gson 包 用 于 存放 GSON 模型 相关 的 代码 , service 
包 用 于 存放 服务 相关 的 代码 ，util 包 用 于 存放 工具 相关 的 代码 。 

根据 14.1 节 进 行 的 技术 可 行 性 分 析 ， 第 一 阶段 我 们 要 做 的 就 是 创建 好 数据 库 和 表 ， 这 样 从 
服务 器 获取 到 的 数据 才能 够 存储 到 本 地 。 关 于 数据 库 和 表 的 创建 方式 , 我 们 早 在 第 6 章 中 就 已 经 
学 过 了 。 那 么 为 了 简化 数据 库 的 操作 ， 这 里 我 准备 使 用 LitePal 来 管理 酷 欧 天 气 的 数据 库 。 

首先 需要 将 项 目 所 需 的 各 种 依赖 库 进 行 声明 ， 编 辑 app/build.gradle 文件 ， 在 dependencies 闭 
包 中 添加 如 下 内 容 : 


dependencies { 
compile fileTree(dir: 'libs', include: ['*.jar']) 
compile 'com.android,.support:appcompat-v7:24.2.1" 
testCompile 'junit:junit:4.12" 
compile 'org.litepal.android:core:1.4.1' 
compile 'com.squareup.okhttp3:okhttp:3.4.1' 
compile 'com.google.code.gson:gson:2.7" 
compile 'com.github.bumptech.glide:glide:3.7.0" 

} 


这 里 声明 的 4 个 库 我 们 之 前 都 是 使 用 过 的 ，LitePal 用 于 对 数据 库 进行 操作 ，OkHttp 用 于 进 
行 网 络 请 求 ，GSON 用 于 解析 JSON 数据 ，Glide 用 于 加 载 和 展示 图 片 。 酷 欧 天 气 将 会 对 这 几 个 
库 进 行 综合 运用 ， 这 里 直接 一 次 性 将 它们 都 添加 进来 。 

然后 我 们 来 设计 一 下 数据 库 的 表 结 构 , 表 的 设计 当然 是 仁者 见 仁 智者 见 智 ， 并 不 是 说 哪 种 设 
计 就 是 最 规范 最 完美 的 。 这 里 我 准备 建立 3 张 表 : province 、city 、county， 分 别 用 于 存放 省 、 市 、 
县 的 数据 信息 。 对 应 到 实体 类 中 的 话 ， 就 应 该 建立 Province、City、County 这 3 个 类 。 

那么 ,在 由 包 下 新 建 一 个 Province 类 ， 代 码 如 下 所 示 : 


public class Province extends DataSupport { 


private int id; 
private String provinceName; 
private int provinceCode; 


public int getId() { 
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return id; 

} 

public void setId(int id) { 
this.id = id; 

} 


public String getProvinceName() { 
return provinceName; 


} 


public void setProvinceName(String provinceName) { 
this.provinceName = provinceName; 


} 


public int getProvinceCode() { 
return provinceCode; 


} 


public void setProvinceCode(int provinceCode) { 
this.provinceCode = provinceCode; 


} 
} 
其 中 ，id 是 每 个 实体 类 中 都 应 该 有 的 字段 ，provinceName 记录 省 的 名 字 ，provinceCode 
记录 省 的 代号 。 另 外 ，LitePal 中 的 每 一 个 实体 类 都 是 必须 要 继承 自 DataSupport 类 的 。 
接着 在 db 包 下 新 建 一 个 City 类 ， 代 码 如 下 所 示 : 
public class City extends DataSupport { 
private int id; 
private String cityName; 
private int cityCode; 
private int provinceld; 


public int getId() { 


return id; 

} 

public void setId(int id) { 
this.id = id; 

} 


public String getCityName() { 
return cityName; 


} 


public void setCityName(String cityName) { 
this.cityName = cityName; 
} 
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public int getCityCode() { 
return cityCode; 


} 


public void setCityCode(int cityCode) { 
this.cityCode = cityCode; 
} 


public int getProvinceId() { 
return provinceld; 


} 


public void setProvinceId(int provinceId) { 
this.provinceId = provinceld; 


} 
} 
其 中 ，cityName 记录 市 的 名 字 ，cityCode 记录 市 的 代号 ，provinceId 记录 当前 市 所 属 省 
的 id 值 。 
然后 在 db 包 下 新 建 一 个 County 类 ， 代 码 如 下 所 示 : 


public class County extends DataSupport { 


private int id; 

private String countyName; 
private String weatherId ; 
private int cityId ; 


public int getId() { 


return id; 

} 

public void setId(int id) { 
this.id = id; 

} 


public String getCountyName() { 
return countyName; 


} 


public void setCountyName(String countyName) { 
this.countyName = countyName; 
} 


public String getweatherId() { 
return weatherId ; 


} 


public void setWeatherId(String weatherId) { 
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this .weatherId = weatherId ; 
} 


public int getCityId() { 
return CityId ; 
} 


public void setCityId(int cityId) { 
this.cityId = CityId ; 
} 
} 
其 中 ，countyName 记录 县 的 名 字 ，weatherId 记录 县 所 对 应 的 天 气 id，cityId 记录 当前 
县 所 属 市 的 id 值 。 
可 以 看 到 ， 实 体 类 的 内 容 都 非常 简单 
和 setter 方法 就 可 以 了 。 
接 下 来 需要 配置 litepal.xml 文件 。 右 击 app/src/main 目录 一 New 一 Directory， 创 建 一 个 assets 
目录 ， 然 后 在 assets 目录 下 再 新 建 一 个 litepal.xml 文件 ， 接 着 编辑 litepal.xml 文件 中 的 内 容 ， 如 
下 所 示 : 


<litepal> 


ll 


， 就 是 声明 了 一 些 需 要 的 字段 ， 并 生成 相应 的 getter 


<dbname value="cool _ weather” /> 

<version value="1" /> 

<list> 
<mapping class="com.coolweather.android.db.Province" /> 
<mapping class="com.coolweather.android.db.City" /> 


<mapping class="com.coolweather.android,.db.County" /> 
</list> 


</litepal> 


这 里 我 们 将 数据 库 名 指定 成 cool _ weather， 数据 库 版 本 指定 成 1， 并 将 Province、City 和 
County 这 3 个 实体 类 添加 到 映射 列表 当中 。 
最 后 还 需要 再 配置 一 下 LitePalApplication ， 修 改 AndroidManifest.xml 中 的 代码 ， 如 下 所 示 : 


<manifest xmlns:android="http://schemas.android.com/apk/res/android" 
package="com.coolweather.android"> 


<application 
android:name="org.litepal .LitePalApplication" 
android:allowBackup="true" 
android:icon="@mipmap/ic launcher" 
android:label="@string/app_name" 
android:supportsRtl="true" 
android:theme="@style/AppTheme"> 
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</application> 

</manifest> 

这 样 我 们 就 将 所 有 的 配置 都 完成 了 , 数据 库 和 表 会 在 首次 执行 任意 数据 库 操作 的 时 候 自动 
创建 。 

好 了 , 第 一 阶段 的 代码 写 到 这 里 就 差不多 了 , 我 们 现在 提交 一 下 。 首 先 将 所 有 新 增 的 文件 添 
加 到 版 本 控制 中 : 

git add ， 

接着 执行 提交 操作 : 

git commit -m "加 入 创建 数据 库 和 表 的 各 项 配置 。" 

最 后 将 提交 同步 到 GitHub 上 面 : 

git push origin master 


OK! 第 一 阶段 完工 ， 下 面 让 我 们 赶快 进入 到 第 二 阶段 的 开发 工作 中 吧 
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在 第 二 阶段 中 ,我 们 准备 把 遍历 全 国 省 市 县 的 功能 加 入 , 这 一 阶段 需要 编写 的 代码 量 比较 大 ， 
你 一 定 要 跟 上 脚步 。 
我 们 已 经 知道 , 全 国 所 有 省 市 县 的 数据 都 是 从 服务 器 端 获 取 到 的 , 因此 这 里 和 服务 器 的 交互 
是 必 不 可 少 的 ， 所 以 我 们 可 以 在 utl 包 下 先 增加 一 个 HttpUtil 类 ， 代 码 如 下 所 示 : 


public class HttpUtil { 


O 


public static void sendOkHttpRequest(String address, okhttp3.Callback callback) { 
OkHttpClient client = new OkHttpClient(); 
Request request = new Request.Builder().url(address).build(); 
client.newCall(request).enqueue(callback); 

} 


} 

由 于 OkHttp 的 出 色 封 装 ， 这 里 和 服务 器 进行 交互 的 代码 非常 简单 ， 仅 仅 3 行 就 完成 了 。 现 
在 我 们 发 起 一 条 HTTP 请 求 只 需要 调用 send0kHttpRequest () 方 法 ， 传 人 请 求 地 址 ， 并 注册 一 
个 回调 来 处 理 服务 器 响应 就 可 以 了 。 

另外 ,由 于 服务 器 返回 的 省 市 县 数据 都 是 JSON 格式 的 ,所 以 我 们 最 好 再 提供 一 个 工具 类 来 
解析 和 处 理 这 种 数据 。 在 util 包 下 新 建 一 个 Utility 类 ， 代 码 如 下 所 示 : 
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public class Utility { 


/** 
* 解析 和 处 理 服务 器 返回 的 省 级 数据 
*/ 


public static boolean handleProvinceResponse(String response) { 
if (!TextUtils.isEmpty(response)) { 
try { 
JSONArray allProvinces = new JS0NArray(response ) ; 
for (int i = 0; i < allProvinces.length(); i++) { 
JSONObject provinceObject = allProvinces.getJSONObject(i); 
Province province = new Province() ; 
province.setProvinceName(provinceObject.getString("name")); 
province.setProvinceCode(provinceObject.getInt("id")); 
province.save(); 
} 
return true; 
} catch (JSONException e) { 
e.printStackTrace(); 
} 
} 
return false; 


} 


/** 
* 解析 和 处 理 服务 器 返回 的 市 级 数据 
*/ 
public static boolean handleCityResponse(String response, int provinceId) { 
if (!TextUtils.isEmpty(response)) { 
try { 
JSONArray allCities = new JSONArray(response); 
for (int i = 0; i < allCities.length(); i++) { 
JSONObject cityObject = allCities.getJSONObject(i); 
City city = new City(); 
city.setCityName(cityO0bject.getString("name")); 
city.setCityCode(cityO0bject.getInt("id")); 
city.setProvinceId(provinceId ) ; 
city.save(); 
} 
return true; 
} catch (JSONException e) { 
e.printStackTrace(); 
} 
} 
return false; 


} 


/A** 
* 解析 和 处 理 服务 器 返回 的 县 级 数据 
*/ 
public static boolean handleCountyResponse(String response, int cityId) { 
if (!TextUtils.isEmpty(response)) { 
try { 
JSONArray allCounties = new JSONArray (response ) ; 
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for (int i = 0; i < allCounties.length(); i++) { 
JSONObject countyObject = allCounties.getJSONObject(i); 


County county = new County(); 


county.setCountyName (countyObject.getString("name")); 
county .setWeatherId(countyObject.getString("weather id")); 


county .setCityId(cityId); 
county .save(); 
} 
return true; 
} catch (JSONException e) { 
e.printStackTrace(); 
} 
} 


return false; 


} 


可 以 看 到 ， 我 们 提供 了 handleProvincesResponse()、handleCitiesResponse()、 


handteCountiesResponse() 这 3 个 方法 ,分 别 用 于 解析 和 处 理 服务 器 返回 的 省 级 、 市 级 和 


县 级 


数据 。 处 理 的 方式 都 是 类 似 的 ， 先 使 用 JSONArray 和 JSONObject 将 数据 解析 出 来 ， 然 后 组 装 成 
实体 类 对 象 ， 再 调用 save ( ) 方 法 将 数据 存储 到 数据 库 当 中 。 由 于 这 里 的 JSON 数据 结构 比较 简 


单 ， 我 们 就 不 使 用 GSON 来 进行 解析 了 。 


需要 准备 的 工具 类 就 这 么 多 , 现在 可 以 开始 写 界面 了 。 由 于 遍历 全 国 省 市 县 的 功能 我 们 在 后 


面 还 会 复 用 ， 因 此 就 不 写 在 活动 里 面 了 ， 而 是 写 在 碎片 里 面 ， 这 样 需要 复 用 的 时 候 直接 在 布局 里 


面 引 用 碎片 就 可 以 了 。 
在 res/layout 目录 中 新 建 choose_area.xml 布局 ， 代 码 如 下 所 示 : 


<LinearLayout 
xmlns:android="http://schemas.android.com/apk/res/android" 
android:orientation="vertical" 
android:layout width="match parent" 
android:layout height="match parent" 
android:background="#fff"> 


<RelativeLayout 
android:layout width="match parent" 
android:layout height="?attr/actionBarSize" 
android:background="?attr/colorPrimary"> 


<TextView 
android:id="@+id/title text" 
android:layout width="wrap_ content" 
android:layout height="wrap_ content" 
android:layout centerInParent="true" 
android:textColor="#fff" 
android:textSize="20sp"/> 


<Button 
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android:id="@+id/back button" 
android:layout width="25dp" 
android:layout height="25dp" 
android:layout marginLeft="10dp" 
android:layout alignParentLeft="true" 
android:layout centerVertical="true" 
android:background="@drawable/ic back"/> 


</RelativeLayout> 


<ListView 


and 
and 
and 


roid:id="@+id/list view" 
roid:layout width="match parent" 
roid:layout height="match parent"/> 


</LinearLayout> 


布局 文件 中 的 内 容 并 不 复杂 , 我 们 先是 定义 了 一 个 头 布局 来 作为 标题 栏 , 将 布局 高 度 设 置 为 


actionBar 的 高 度 ， 


题 内 容 ， 放 置 了 一 个 Button 用 于 执行 返回 操作 ， 注 意 我 已 经 提前 准备 好 了 一 张 ic_back.png 图 


用 于 作为 按钮 的 


ActionBar 或 Toolbar， 不 然 在 复 用 的 时 候 可 能 会 出 现 一 些 你 不 想 看 到 的 效果 。 
接 下 来 在 头 布局 的 下 面 定 义 了 一 个 ListView ， 省 有 


背景 色 设 置 为 colorPrimary。 然 后 在 头 布 局 中 放置 了 一 个 TextView 用 于 显示 标 


片 


背景 图 。 这 里 之 所 以 要 自己 定义 标题 栏 ， 是 


因为 碎片 中 最 好 不 要 直接 使 


和 县 的 数据 就 将 显示 在 这 里 。 之 所 以 这 次 使 


用 了 ListView, 是 因为 它 会 自动 给 每 个 子 项 之 间 添 加 一 条 分 隔 线 , 而 如 果 使 用 RecyclerView 想 
现 同样 的 功能 则 会 比较 麻烦 ， 这 里 我 们 总 是 选择 最 优 的 实现 方案 。 

接 下 来 也 是 最 关键 的 一 步 ， 我 们 需要 编写 用 于 遍历 省 市 县 数据 的 碎片 了 。 新 建 Choose- 
AreaFragment 继承 自 Fragment， 代 码 如 下 所 示 : 


public class ChooseAreaFragment extends Fragment { 


public static final int LEVEL PROVINCE = 0; 


public static final int LEVEL CITY = 1; 


public static final int LEVEL COUNTY = 2; 


private 
private 
private 
private 
private 


private 


/** 


ProgressDialog progressDialog; 
TextView titleText; 
Button backButton; 
ListView listView; 
ArrayAdapter<String> adapter; 


List<String> dataList = new ArrayList<>(); 


* 省 列表 


月 


bene 


实 
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WA 
private List<Province> provincelist; 


private List<City> cityList; 


/沙沙 

* 县 列表 

A 
private List<County> countyList; 


/冰冰 
* 选中 的 省 份 
*/ 
private Province selectedProvince; 


/沙沙 

* 选中 的 城市 

水 
private City seLectedCity ; 


/冰冰 
* 当前 选中 的 级 别 
*/ 
private int currentLevel,; 


GOverride 
public View onCreateView(LayoutInfLater inflater, ViewGroup container， 
Bundle savedInstanceState) { 


View view = inflater.inflate(R.layout.choose area, container, false); 
titLeText = (TextView) view.findViewById(R.id.title text); 
backButton (Button) view.findViewById(R.id.back button); 


listView = (ListView) view.findViewById(R.id.list view); 

adapter = new ArrayAdapter<>(getContext(), android.R.layout.simple List 
item 1, dataList); 

listView.setAdapter(adapter); 

return view; 


} 


GOverride 

public void onActivityCreated(Bundle SavedInstanceState) { 
super.onActivityCreated(savedInstanceState); 
listView.setOnItemClickListener(new AdapterView.OnItemClickListener() { 


@Override 
public void onItemClick(AdapterView<?> parent, View view, int position, 
Long id) { 


if (currentLevel == LEVEL PROVINCE) { 
selectedProvince = provinceList.get(position); 
queryCities(); 

} else if (currentLevel == LEVEL CITY) { 
selectedCity = cityList.get(position); 
queryCounties(); 
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} 
} 
}); 
backButton.setOnClickListener(new View.0nCLickListener() { 
@Override 
public void onClick(View v) { 
if (currentLevel == LEVEL COUNTY) { 
queryCities(); 
} else if (currentLevel == LEVEL CITY) { 
queryProvinces(); 
} 
} 
}); 
queryProvinces(); 
} 
7/ 


* 查询 全 国 所 有 的 省 ,优先 从 数据 库 查询 ， 如 果 没 有 查询 到 再 去 服务 器 上 查询 
*/ 
private void queryProvinces() { 
titleText.setText(" 中 国 "); 
backButton.setVisibility(View.GONE); 
provinceList = DataSupport.findAll (Province.class); 
if (provinceList,.size() > 0) { 
dataList.clear(); 
for (Province province : provinceList) { 
dataList.add(province.getProvinceName()); 
} 
adapter.notifyDataSetChanged(); 
listView.setSelection(0); 
currentLevel = LEVEL PROVINCE; 
} else { 
String address = "http://guolin.tech/api/china"; 
queryFromServer(address, "province"); 


} 


/** 
* 查询 选中 省 内 所 有 的 市 ， 优 先 从 数据 库 查询 ， 如 果 没 有 查询 到 再 去 服务 器 上 查询 
*/ 
private void queryCities() { 
titleText.setText(selectedProvince.getProvinceName()); 
backButton.setVisibility(View.VISIBLE); 
cityList = DataSupport.where("provinceid = ?", String.value0f(selected 
Province.getId())).find(City.class); 
if (cityList.size() > 0) { 
dataList.clear(); 
for (City city : cityList) { 
dataList.add(city.getCityName()); 
} 
adapter.notifyData9etChanged () ; 
listView.setSelection(0); 
currentLevel = LEVEL CITY; 
} else { 
int provinceCode = selectedProvince.getProvinceCode(); 
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String address = "http://guolin.tech/api/china/" + provinceCode; 
queryFromServer(address, "city"); 


} 


/沙沙 
* 查询 选中 市 内 所 有 的 县 ， 优 先 从 数据 库 查 询 ， 如 果 没有 查询 到 再 去 服务 器 上 查询 
*/ 
private void queryCounties() { 

titleText.setText(selectedCity.getCityName()); 

backButton.setVisibility(View.VISIBLE); 

countyList = DataSupport.where("cityid = ?", String.value0f(selectedCity. 
getId())).find(County.class); 

if (countyList.size() > 0) { 
dataList.cLtear(); 
for (County county : countyList) { 

dataList.add(county.getCountyName()); 

} 
adapter.notifyData9etChanged () ; 
listView.setSelection(0); 
currentLevel = LEVEL COUNTY; 

} else { 
int provinceCode = selectedProvince.getProvinceCode(); 
int cityCode = selectedCity.getCityCode(); 
String address = "http://guolin,.tech/api/china/" + provinceCode + "/" + 

cityCode; 

queryFromServer(address, "county"); 


} 
} 
/** 
* 根据 传 入 的 地 址 和 类 型 从 服务 器 上 查询 省 市 县 数据 
*/ 


private void queryFromServer(String address, final String type) { 
showProgressDialog(); 
HttpUtil.sendOkHttpRequest(address, new Callback() { 
@Override 
public void onResponse(Call call, Response response) throws IOException { 
String responseText = response.body().string(); 
boolean result = false; 
if ("province".equals(type)) { 
result = Utility.handleProvinceResponse(responseText); 
} else if ("city".equals(type)) { 
result = Utility.handleCityResponse(responseText, 
selectedProvince.getId()); 
} else if ("county".equals(type)) { 
result = Utility.handleCountyResponse(responseText, 
selectedCity.getId()); 
} 
if (result) { 
getActivity().runOnUiThread(new Runnable() { 
@Override 
public void run() { 
closeProgressDialog(); 
if ("province".equals(type)) { 


506 第 14 章 进入 实战 一 一 开发 酷 欧 天 气 


queryProvinces(); 

} else if ("city".equals(type)) { 
queryCities(); 

} else if ("county".equals(type)) { 
queryCounties(); 


@Override 
public void onFailure(Call call, IOException e) { 
// 通过 run0nUiThread ( ) 方 法 回 到 主线 程 处 理 逻 辑 
getActivity().runOnUiThread(new Runnable() { 
@Override 
public void run() { 
closeProgressDialog(); 
Toast.makeText(getContext(), "加载 失 败 ",，Toast,LENGTH_SHORT). 


show(); 
} 
}); 
} 
}); 
} 
/沙沙 
* 显示 进度 对 话 框 
*/ 


private void showProgressDialog() { 
if (progressDialog == null) { 
progressDialog = new ProgressDialog(getActivity()); 
progressDialog.setMessage(" 正 在 加 载 ..."); 
progressDialog.setCanceledOnTouchOutside(false); 
} 
progressDialog.show(); 
} 


/沙沙 
* 关闭 进度 对 话 框 
4 
private void closeProgressDialog() { 
if (progressDialog != null) { 
progressDialog.dismiss(); 
} 


} 


这 个 类 里 的 代码 虽然 非常 多 ， 可 是 逻辑 却 不 复杂 ,我们 来 慢 慢 理 一 下 。 在 onCreateView() 
方法 中 先是 获取 到 了 一 些 控件 的 实例 ,然后 去 初始 化 了 ArrayAdapter,， 并 将 它 设置 为 ListView 的 
适配器 。 接 着 在 onActivityCreated ( ) 方 法 中 给 ListView 和 Button 设置 了 点 击 事件 ， 到 这 里 我 
们 的 初始 化 工作 就 算是 完成 了 。 
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在 onActivityCreated () 方 法 的 最 后 ， 调 用 了 queryProvinces() 方 法 ， 也 就 是 从 这 里 开 
始 加 载 省 级 数据 的 。queryProvinces () 方 法 中 首先 会 将 头 布局 的 标题 设置 成 中 国 ， 将 返回 按钮 
隐藏 起 来 ， 因 为 省 级 列表 已 经 不 能 再 返回 了 。 然 后 调用 LitePal 的 查询 接口 来 从 数据 库 中 读 取 省 
级 数据 ， 如 果 读 取 到 了 就 直接 将 数据 显示 到 界面 上 ， 如 果 没 有 读 取 到 就 按照 14.1 节 讲 述 的 接口 
组 装 出 一 个 请 求 地 址 ， 然 后 调用 queryFromServer() 方 法 来 从 服务 器 上 查询 数据 。 


queryFromServer() 方 法 中 会 调用 HttpUtil 的 send0kHttpRequest () 方 法 来 向 服务 器 发 送 
请 求 ， 响 应 的 数据 会 回调 到 onResponse() 方 法 中 ， 然 后 我 们 在 这 里 去 调用 Utility 的 
handleProvincesResponse() 方 法 来 解析 和 处 理 服 务 器 返回 的 数据 ， 并 存储 到 数据 库 中 。 接 下 
来 的 一 步 很 关键 , 在 解析 和 处 理 完 数据 之 后 , 我 们 再 次 调用 了 queryProvinces() 方 法 来 重新 加 
载 省 级 数据 ， 由 于 queryProvinces() 方 法 牵扯 到 了 UI 操作， 因此 必须 要 在 主线 程 中 调用 ， 这 
里 借助 了 run0nUiThread() 方 法 来 实现 从 子 线 程 切换 到 主线 程 ,现在 数据 库 中 已 经 存在 了 数据 ， 
因此 调用 queryProvinces() 就 会 直接 将 数据 显示 到 界面 上 了 。 


当 你 点 击 了 某 个 省 的 时 候 会 进入 到 ListView 的 onItemClick() 方 法 中 ， 这 个 时 候 会 根据 当 
前 的 级 别 来 判断 是 去 调用 queryCities() 方 法 还 是 queryCounties () 方 法 ，queryCities () 方 
法 是 去 查询 市 级 数据 ， 而 queryCounties () 方 法 是 去 查询 县 级 数据 ， 这 两 个 方法 内 部 的 流程 和 
queryProvinces () 方 法 基本 相同 ， 这 里 就 不 重复 讲解 了 。 


另外 还 有 一 点 需要 注意 ,在 返回 按钮 的 点 击 事件 里 ,会 对 当前 ListView 的 列表 级 别 进行 判断 。 
如 果 当 前 是 县 级 列表 , 那么 就 返回 到 市 级 列表 , 如 果 当 前 是 市 级 列表 , 那么 就 返回 到 省 级 表 列表 。 
当 返 回 到 省 级 列表 时 ， 返回 按 钮 会 自动 隐藏 ， 从 而 也 就 不 需要 再 做 进一步 的 处 理 了 。 
这 样 我 们 就 把 遍历 全 国 省 市 县 的 功能 完成 了 , 可 是 碎片 是 不 能 直接 显示 在 界面 上 的 ,因此 我 
们 还 需要 把 它 添加 到 活动 里 才 行 。 修 改 activity_main.xml 中 的 代码 ， 如 下 所 示 : 
<FrameLayout 
xmlns:android="http://schemas.android.com/apk/res/android" 


android:layout width="match parent" 
android:layout height="match parent"> 


<fragment 
android:id="@+id/choose area fragment" 
android:name="com.coolweather.android.ChooseAreaFragment" 
android:layout width="match parent" 
android:layout height="match parent" /> 


</FrameLayout> 

布局 文件 很 简单 ， 只 是 定义 了 一 个 FrameLayout， 然 后 将 ChooseAreaFragment 添加 进来 ， 并 
让 它 充 满 整个 布局 。 

另外 ,我们 刚才 在 碎片 的 布局 里 面 已 经 自 定义 了 一 个 标题 栏 ， 因 此 就 不 再 需要 原生 的 
ActionBar 了 ， 修 改 res/values/styles.xml 中 的 代码 ， 如 下 所 示 : 
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<resources> 


<!-- Base application theme. --> 
<style name="AppTheme" parent="Theme.AppCompat.Light.NoActionBar"> 


</style> 
</resources> 
现在 第 二 阶段 的 开发 工作 也 完成 得 差不多 了 , 我 们 可 以 运行 一 下 来 看 看 效果 。 不 过 在 运行 之 
前 还 有 一 件 事 没有 做 , 那 就 是 声明 程序 所 需要 的 权限 。 修改 AndroidManifest.xml 中 的 代码 ， 如 下 
所 示 : 


<manifest xmlns:android="http://schemas.android.com/apk/res/android" 
package="com.coolweather.android"> 


<uses-permission android:name="android.permission.INTERNET" /> 


</manifest> 

由 于 我 们 是 通过 网 络 接 口 来 获取 全 国 省 市 县 数据 的 ， 因 此 必须 要 添加 访问 网 络 的 权限 才 行 。 

现在 可 以 运行 一 下 程序 了 ， 结 果 如 图 14.18 所 示 。 

可 以 看 到 , 全国 所 有 省 级 数据 都 显示 出 来 了 。 我 们 还 可 以 继续 查看 市 级 数据 ， 比 如 点 击 江苏 
省 ， 结 果 如 图 14.19 所 示 。 

这 个 时 候 标题 栏 上 会 出 现 一 个 返回 按钮 ， 用 于 返回 上 一 级 列表 。 

然后 再 点 击 苏州 市 查看 县 级 数据 ， 结 果 如 图 14.20 所 示 。 


3 2:40 WW 2:45 
中 国 i 苏州 

北京 苏州 

上 海 无 锡 常 出 

天 津 镇 江 张家港 

重庆 苏州 昆山 

香港 南通 吴 中 
澳门 扬州 吴江 

台 盐城 太仓 

黑龙 江 徐州 
吉林 淮安 
辽宁 连云港 

内 蒙古 常州 

司 北 泰州 


河 


图 14.18 ”显示 省 级 数据 图 14.19 显示 市 级 数据 图 14.20 显示 县 级 数据 
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好 了 ， 这 样 第 二 阶段 的 开发 工作 也 都 完成 了 ， 我 们 仍然 要 把 代码 提交 一 下 。 
git add . 

git commit -m "完成 遍历 省 市 具 三 级 列表 的 功能 。" 

git push origin master 


到 目前 为 止 进度 算是 相当 不 错 啊 ， 那 么 我 们 就 趁 热 打铁 ， 来 进行 第 三 阶段 的 开发 工作 。 
14.5 显示 天 气 信 息 


在 第 三 阶段 中 , 我们 就 要 开始 去 查询 天 气 , 并 且 把 天 气 信息 显示 出 来 了 。 由 于 和 风 天 气 返 回 
的 JSON 数据 结构 非常 复杂 ， 如 果 还 使 用 JSONObject 来 解析 就 会 很 麻烦 ， 这 里 我 们 就 准备 借助 
GSON 来 对 天 气 信息 进行 解析 了 。 


14.5.1 定义 GSON 实体 类 


GSON 的 用 法 很 简单 ， 解 析 数 据 只 需要 一 行 代 码 就 能 完成 了 , 但 前 提 是 要 先 将 数据 对 应 的 实 
体 类 创建 好 。 由 于 和 风 天 气 返回 的 数据 内 容 非 常 多 ， 这 里 我 们 不 可 能 将 所 有 的 内 容 都 利用 起 来 ， 
因此 我 科 选 了 一 些 比 较 重 要 的 数据 来 进行 解析 。 

首先 我 们 回顾 一 下 返回 数据 的 大 致 格式 : 

下 


"HeWeather": [ 
{ 


"suggestion": {}, 
"daily forecast": [] 


} 


其 中 ，basic、aqi、now、suggestion 和 daily forecast 的 内 部 又 都 会 有 具体 的 内 容 ， 
那么 我 们 就 可 以 将 这 5 个 部 分 定义 成 5 个 实体 类 。 


下 面 开始 来 一 个 个 看 ，basic 中 具体 内 容 如 下 所 示 : 


"basic":{ 
"city": "苏州"， 
"id":"CN101190401", 
"update":{ 
"loc":"2016-08-08 21:58" 


} 
} 


其 中 ，city 表示 城市 名 ，id 表示 城市 对 应 的 天 气 id，update 中 的 Loc 表示 天 气 的 更 新 时 
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间 。 我 们 按照 此 结构 就 可 以 在 gson 包 下 建立 一 个 Basic 类 ,代码 如 下 所 示 : 


public class Basic { 


@SerializedName("city") 
public String cityName; 


@SerializedName("id") 
public String weatherId; 


public Update update; 


public class Update { 


@SerializedName("loc") 
public String updateTime; 


} 


由 于 JSON 中 的 一 些 字段 可 能 不 太 适 合 直接 作为 Java 字段 来 命名 ， 因 此 这 里 使 用 了 
@SerializedName 注解 的 方式 来 让 JSON 字段 和 Java 字段 之 间 建 立 映射 关系 。 

这 样 我 们 就 将 Basic 类 定义 好 了 ， 还 是 挺 容易 理解 的 吧 ? 其 余 的 几 个 实体 类 也 是 类 似 的 ， 
我 们 使 用 同样 的 方式 来 定义 就 可 以 了 。 比 如 aqi 中 的 具体 内 容 如 下 如 示 : 


"aqi":{ 

"city":{ 
"aqi":"44", 
"pm25":"13" 

} 

} 


那么 ,在 gson 包 下 新 建 一 个 AQI 类 ， 代码 如 下 所 示 : 


public class AQI { 
public AQICity city; 
public class AQICity { 
public String aqi; 


public String pm25; 


} 
now 中 的 具体 内 容 如 下 所 示 : 


"now":{ 
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"tmp" : 2 
"cond":{ 
wtxt! : 阵雨 " 
} 


} 
那么 , 在 gson 包 下 新 建 一 个 Now 类 ， 代 码 如 下 所 示 : 
public class Now { 


@SerializedName("tmp") 
public String temperature; 


@SerializedName("cond") 
public More more; 


public class More { 


@SerializedName("txt") 
public String info; 


} 
suggestion 中 的 具体 内 容 如 下 所 示 : 


"suggestion":{ 
"comf":{ 
"txt":" 白 天 天 气 较 热 ， 虽 然 有 雨 ， 但 仍然 无 法 削弱 较 高 气温 给 人 们 带 来 的 署 意 ， 
这 种 天 气 会 让 您 感到 不 很 舒适 。" 


}, 
"cw":{ 
"txt": "不宜 洗车 ， 未 来 24 小 时 内 有 雨 ， 如 果 在 此 期 间 洗 车 ， 雨 水 和 路 上 的 泥水 
可 能 会 再 次 弄 脏 您 的 爱 车 。" 
}, 
"sport":{ 
"txt":" 有 降水 ， 且 风力 较 强 ， 推 荐 您 在 室内 进行 低 强 度 运动 ; 若 坚 持 户外 运动 ， 
请 选择 避 雨 防风 的 地 点 。" 
} 


} 
那么 ,在 gson 包 下 新 建 一 个 Suggestion 类 ， 代 码 如 下 所 示 : 
public class Suggestion { 


@SerializedName ("comf") 
public Comfort comfort; 


@SerializedName ("cw") 
public CarWash carwash ; 


public Sport sport; 
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public class Comfort { 


@SerializedName ("txt") 
public String info; 


} 
public class CarWash { 


@SerializedName ("txt") 
public String info; 


} 
public class Sport { 


@SerializedName ("txt") 
public String info; 


} 


到 目前 为 止 都 还 比较 简单 ,不 过 接 下 来 的 一 项 数据 就 有 点 特殊 了 ,daily_forecast 中 的 具 
体内 容 如 下 所 示 : 


"daily forecast":[ 


{ 
"date":"2016-08-08", 
"cond":{ 
"txt_d":" 阵 雨 " 
}, 
"tmp":{ 
"max":"34", 
"min":"27" 
} 
}, 
{ 
"date":"2016-08-09", 
"cond":{ 
"Xtad "3 务 云 
小 5 
"tmp":{ 
"max":"35", 
"min":"29" 
} 


} 

可 以 看 到 ,daily_forecast 中 包含 的 是 一 个 数组 ,数组 中 的 每 一 项 都 代表 着 未 来 一 天 的 天 
气 信 息 。 针 对 于 这 种 情况 ,我 们 只 需要 定义 出 单 日 天 气 的 实体 类 就 可 以 了 ,然后 在 声明 实体 类 引 
用 的 时 候 使 用 集合 类 型 来 进行 声明 。 
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那么 在 gson 包 下 新 建 一 个 Forecast 类 ， 代 码 如 下 所 示 : 


public class Forecast { 
public String date; 


@SerializedName ("tmp") 
public Temperature temperature; 


@SerializedName ("cond") 
public More more; 


public class Temperature { 
public String max; 
public String min; 

} 

public class More { 


@SerializedName ("txt d") 
public String info; 


} 


这 样 我 们 就 把 basic、aqi、now、suggestion 和 daily forecast 对 应 的 实体 类 全 部 都 创 
建 好 了 ， 接 下 来 还 需要 再 创建 一 个 总 的 实例 类 来 引用 刚刚 创建 的 各 个 实体 类 。 在 gson 包 下 新 建 
一 个 Weather 类 ， 代 码 如 下 所 示 : 


public class Weather { 


mi 


public String status ; 

public Basic basic; 

public AQI aqi; 

public Now now; 

public Suggestion suggestion; 


@SerializedName("daily forecast") 
public List<Forecast> forecastList; 


} 


在 Weather 类 中 ,我 们 对 Basic、AQI、Now、Suggestion 和 Forecast 类 进行 了 引用 。 其 
中 ,由 于 daily_forecast 中 包含 的 是 一 个 数组 , 因此 这 里 使 用 了 List 集合 来 引用 Forecast 类 。 
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另外 , 返回 的 天 气 数据 中 还 会 包含 一 项 status 数据 ， 成 功 返 回 ok， 失 败 则 会 


么 这 里 也 需要 添加 一 个 对 应 的 status 字段 。 


现在 所 有 的 GSON 实体 类 都 定义 好 了 ， 接 下 来 我 们 开始 编写 天 气 界面 。 


14.5.2 ” 编 瑟 天 气 界面 


返回 具体 的 原因 , 那 


首先 创建 一 个 用 于 显示 天 气 信息 的 活动 。 右 击 com.coolweatherandroid 包 一 New 一 Activity 一 
Empty Activity， 创 建 一 个 WeatherActivity， 并 将 布局 名 指定 成 activity _ weatherxml。 


由 于 所 有 的 天 气 信息 都 将 在 同一 个 界面 上 显示 , 因此 activity _ weatherxml 会 是 一 个 很 长 的 布 


局 文件 。 那 么 为 了 让 里 面 的 代码 不 至 于 混乱 不 堪 ， 这 里 我 准备 使 用 3.4.1 小 节 学 过 的 引入 布局 技 
术 ， 即 将 界面 的 不 同 部 分 写 在 不 同 的 布局 文件 里 面 ， 再 通过 引入 布局 的 方式 集成 到 activity_ 


weatherxml 中 ， 这 样 整 个 布局 文件 就 会 显得 非常 工整 


人 代码 如 下 所 示 


<RelativeLayout 


xmlns:android="http://schemas.android.com/apk/res/android" 


android:layout width="match parent" 
android:layout height="?attr/actionBarSize"> 


<TextView 
android:id="@+id/title city" 
android:layout width="wrap content" 
android:layout height="wrap content" 
android:layout centerInParent="true" 
android:textColor="#fff" 
android:textSize="20sp" /> 


<TextView 
android:id="@+id/title update time" 
android:layout width="wrap_ content" 
android:layout height="wrap content" 
android:layout marginRight="10dp" 
android:layout alignParentRight="true" 
android:layout centerVertical="true" 
android:textColor="#fff" 
android:textSize="16sp"/> 


</RelativeLayout> 


这 上段 代码 还 是 比较 简单 的 , 头 布局 中 放置 了 两 个 TextView， 
显示 更 新 时 间 。 


一 个 居中 显示 城市 名 ， 


然后 新 建 一 个 now.xml 作 为 当前 天 气 信息 的 布局 ， 代 码 如 下 所 示 : 


<LinearLayout 


xmlns:android="http://schemas.android.com/apk/res/android" 


android:orientation="vertical" 


一 个 居 右 
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android:layout width="match parent" 
android:layout height="wrap content" 
android:layout margin="15dp"> 


<TextView 
android:id="@+id/degree text" 
android:layout width="wrap_content" 
android:layout height="wrap content" 
android:layout gravity="end" 
android:textColor="#fff" 
android:textSize="60sp" /> 


<TextView 
android:id="@+id/weather info text" 
android:layout width="wrap content" 
android:layout height="wrap_ content" 
android:layout gravity="end" 
android:textColor="#fff" 
android:textSize="20sp" /> 


</LinearLayout> 


当前 天 气 信 息 的 布局 中 也 是 放置 了 两 个 TextView, 一 个 用 于 显示 当前 气温 , 一 个 用 于 显示 天 
气概 况 。 


然后 新 建 forecast.xml 作为 未 来 几 天 天 气 信息 的 布局 ， 代 码 如 下 所 示 : 


<LinearLayout 
xmlns:android="http://schemas.android.com/apk/res/android" 
android:orientation="vertical" 
android:layout width="match parent" 
android:layout height="wrap_ content" 
android:Layout margin="15dp" 
android:background="#8000"> 


<TextView 
android:layout width="wrap_content" 
android:layout height="wrap content" 
android:layout marginLeft="15dp" 
android:layout marginTop="15dp" 
android:text=" 预 报 " 
android:textColor="#fff" 
android:textSize="20sp"/> 


<LinearLayout 
android:id="@+id/forecast layout" 
android:orientation="vertical" 
android:layout width="match parent" 
android:layout height="wrap content"> 
</LinearLayout> 


</LinearLayout> 


这 里 最 外 层 使 用 LinearLayout 定义 了 一 个 半 透 明 的 背景 ， 然 后 使 用 TextView 定义 了 一 个 标 
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题 , 接着 义 使 用 一 个 LinearLayout 定义 了 一 个 用 于 显示 未 来 几 天 天 气 
中 并 没有 放 入 任何 内 容 ， 因 为 这 是 要 根据 服务 器 返回 的 数据 在 代码 中 动态 添加 的 。 


为 此 ， 我 们 还 需要 再 定义 一 个 未 来 天 气 信息 的 子 项 布局 ， 


如 下 所 示 : 


言 息 的 布局 。 不 过 这 个 布局 


创建 forecast_item.xml 文件 ， 代 码 


<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:layout width="match parent" 
android:layout height="wrap content" 


android:layout margin="15dp"> 


<TextView 


android:id="@+id/date text" 
android:Layout width="0dp" 


android:layout height="wrap content" 
android:layout gravity="center vertical" 


android:layout weight="2" 


android:textColor="#fff"/> 


<TextView 


android:id="@+id/info text" 
android:Layout width="0dp" 


android:Layout height="wrap content" 
android:layout gravity="center vertical" 


android:layout weight="1" 
android:gravity="center" 


android:textColor="#fff"/> 


<TextView 


android:id="@+id/max text" 
android:Layout width="0dp" 


android:Layout height="wrap content" 
android:layout gravity="center" 


android:layout weight="1" 
android:gravity="right" 


android:textColor="#fff"/> 


<TextView 


android:id="@+id/min text" 
android:Layout width="0dp" 


android:layout height="wrap content" 
android:layout gravity="center" 


android:layout weight="1" 
android:gravity="right" 


android:textColor="#fff"/> 


</LinearLayout> 


子 项 布局 中 放置 了 4 个 TextView, 一 个 


月 


外 两 个 分 别 用 于 显示 当天 的 最 高 温度 和 最 低温 度 。 
然后 新 建 aqi.xml 作为 空气 质量 信息 的 布局 ， 代 码 如 下 所 示 : 


记 


有 于 显示 天 气 预报 日 期 ， 


一 个 用 于 显示 天 气概 况 ， 另 
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息 


317 


<LinearLayout 


xmlns:android="http://schemas.android.com/apk/res/android" 
android:orientation="vertical" 

android:layout width="match parent" 

android:layout height="wrap content" 

android:layout margin="15dp" 

android:background="#8000"> 


<TextView 
android:layout width="wrap content" 
android:layout height="wrap content" 
android:layout marginLeft="15dp" 
android:layout marginTop="15dp" 
android:text=" 空 气质 量 " 
android:textColor="#fff" 
android:textSize="20sp"/> 

<LinearLayout 
android:layout width="match parent" 
android:layout height="wrap_ content" 
android:layout margin="15dp"> 
<RelativeLayout 


android:layout width="0dp" 
android:layout height="match parent" 
android:layout weight="1"> 


<LinearLayout 


android:orientation="vertical" 
android:layout width="match parent" 
android:layout height="wrap content" 
android:layout centerInParent="true"> 


<TextView 
android:id="@+id/aqi text" 
android:layout width="wrap content" 
android:layout height="wrap content" 
android:layout gravity="center" 
android:textColor="#fff" 
android:textSize="40sp" 
/> 


<TextView 
android:layout width="wrap content" 
android:layout height="wrap_ content" 
android:layout gravity="center" 
android:text="AQI 指数 " 
android:textColor="#fff"/> 


</LinearLayout> 


</RelativeLayout> 


<RelativeLayout 
android:layout width="0dp" 
android:layout height="match parent" 
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android:layout weight="1"> 


<LinearLayout 
android:orientation="vertical" 
android:layout width="match parent" 
android:layout height="wrap_ content" 
android:layout centerInParent="true"> 


<TextView 
android:id="@+id/pm25 text" 
android:layout width="wrap content" 
android:layout height="wrap content" 
android:layout gravity="center" 
android:textColor="#fff" 
android:textSize="40sp" 
/> 


<TextView 
android:layout width="wrap content" 
android:layout height="wrap content" 
android:layout gravity="center" 
android:text="PM2.5 指数 " 
android:textColor="#fff" 
/> 


</LinearLayout> 
</RelativeLayout> 
</LinearLayout> 


</LinearLayout> 


个 布局 中 的 代码 虽然 看 上 去 有 点 长 ， 但 是 并 不 复杂 。 首 先前 面 都 是 一 样 的， 使 用 
> 一 个 半 透 明 的 背景 ， 然 后 使 用 TextView 定义 了 一 个 标题 。 接 下 来 ， 这 里 使 用 
ne 和 开 elalivelayot 哆 全 的 办 区 讽 卫 二 个 宇和 下 分 四 司 后 中 各 2 汐 币 同 办 刘 用 于 
显示 AQI 指 数 和 PM 2.5 指数 。 相 信 你 只 要 仔细 看 一 看 ， 这 个 布局 还 是 很 好 理解 的 。 


然后 新 建 suggestion.xml 作为 生活 建议 信息 的 布局 ,代码 如 下 所 示 : 


<LinearLayout 
xmlns:android="http://schemas.android.com/apk/res/android" 
android:orientation="vertical" 
android:layout width="match parent" 
android:layout height="wrap content" 
android:layout margin="15dp" 
android:background="#8000"> 


<TextView 
android:layout width="wrap content" 
android:layout height="wrap content" 
android:Layout marginLeft="15dp" 
android:Layout marginTop="15dp" 
android:text=" 生 活 建议 " 
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android: 
android: 


<TextView 
android: 
android: 
android: 
android: 
android: 


<TextView 
android: 
android: 
android: 
android: 
android: 


<TextView 
android: 
android: 
android: 
android: 
android: 


</LinearLayout> 


textColor="#fff" 
textSize="20sp"/> 


id="@+id/comfort text" 
layout width="wrap_ content" 
layout height="wrap content" 
layout margin="15dp" 
textColor="#fff" /> 


id="@+id/car wash text" 
layout width="wrap content" 
layout height="wrap_ content" 
layout margin="15dp" 
textColor="#fff" /> 


id="@+id/sport text" 
layout width="wrap_ content" 
layout height="wrap_ content" 
layout margin="15dp" 
textColor="#fff" /> 


这 里 同样 也 是 先 定义 了 一 个 半 透 明 的 背景 和 一 个 标题 ， 然 后 下 面 使 用 了 3 个 TextView 分 别 


用 于 显示 舒适 度 、 洗 车 指数 和 运动 建议 的 相关 数据 。 


这 样 我 们 就 把 天 气 界面 上 每 个 部 分 的 布局 文件 都 编写 好 了 , 接 下 来 的 工作 就 是 将 它们 引入 到 
activity weatherxml 当中 ， 如 下 所 示 : 


<FrameLayout 


xmlns:android="http://schemas.android.com/apk/res/android" 
android:layout width="match parent" 

android:layout height="match parent" 
android:background="@color/colorPrimary"> 


<ScrollView 
android:id="@+id/weather layout" 
android:layout width="match parent" 
android:layout height="match parent" 
android:scrollbars="none" 
android:overScrollMode="never"> 
<LinearLayout 


android:orientation="vertical" 
android:layout width="match parent" 
android:layout height="wrap content"> 


<include layout="@layout/title" /> 


<include layout="@layout/now" /> 
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<include layout="@layout/forecast" /> 
<include layout="@layout/aqi" /> 
<include layout="@layout/suggestion" /> 
</LinearLayout> 
</ScrollView> 
</FrameLayout> 
可 以 看 到 ， 首 先 最 外 层 布 局 使 用 了 一 个 FrameLayout， 并 将 它 的 背景 色 设置 成 colorPrimary。 


然后 在 FrameLayout 中 租 套 了 一 个 ScrollView， 这 是 因为 天 气 界面 中 的 内 容 比 较 多 ,使 用 
ScrollView 可 以 允许 我 们 通过 滚动 的 方式 查看 屏幕 以 外 的 内 容 。 


由 于 ScrollView 的 内 部 只 允许 存在 一 个 直接 子 布 局 ， 因 此 这 里 又 能 套 了 一 个 垂直 方向 的 
LinearLayout， 然 后 在 LinearLayout 中 将 刚才 定义 的 所 有 布局 逐个 引入 。 


这 样 我 们 就 将 天 气 界 面 编写 完成 了 ， 接 下 来 开始 编写 业务 逻辑 ， 将 天 气 显 示 到 界面 上 。 
14.5.3 ”将 天 气 显示 到 界面 上 


首先 需要 在 Utility 类 中 添加 一 个 用 于 解析 天 气 JSON 数据 的 方法 ， 如 下 所 示 : 
public class Utility { 


/** 
六 将 返回 的 JSON 数据 解析 成 Weather 实体 类 
*/ 
public static Weather handleWeatherResponse(String response) { 
try { 
JSONObject json0bject = new JSONObject(response); 
JSONArray jsonArray = jsonObject.getJSONArray ("HeWeather"); 
String weatherContent = jsonArray.getJSONObject(0).toString(); 
return new Gson().fromjson(weatherContent, Weather.class); 
} catch (Exception e) { 
e.printStackTrace(); 


return null; 


} 


可 以 看 到 ,handleWeatherResponse() 方 法 中 先是 通过 JSONObject 和 JSONArray 将 天 气 
数据 中 的 主体 内 容 解 析出 来 ， 即 如 下 内 容 : 


{ 


"status": "ok", 
"basic": {}, 
"aqi": {}, 
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{}, 


"now": {}, 
"suggestion": 
"daily forecast": [] 
} 
然后 由 于 我 们 之 前 


已 经 按照 上 面 的 数据 格式 定义 过 相应 的 GSON 实体 类 ， 因 此 只 需要 通过 


调用 fromJjson() 方 法 就 能 直接 将 JSON 数据 转换 成 Weather 对 象 了 。 


SN 


接 下 来 的 工作 是 


牙 们 如 何在 活动 中 去 请 求 天 气 数 据 ， 以 及 将 数据 展示 到 界面 上 。 修 改 


WeatherActivity 中 的 代码 ， 如 下 所 示 : 


public class WeatherActivity extends AppCompatActivity { 


private ScrollView weatherLayout ; 


private TextView titLeCity 


private TextView titLeUpdateTime 


private TextView degreeText ; 


private TextView weatherInfoText 


private LinearLayout forecastLayout ; 


private TextView aqiText; 


private TextView pm25Text; 


private TextView comfortText; 


private TextView carWashText; 


private TextView sportText; 


GOverride 


protected void onCreate(Bundle savedInstanceState) { 
super.onCreate(savedInstanceState); 
setContentView(R.layout.activity weather); 
// 初始 化 各 控件 
weatherLayout = (ScrollView) findViewById(R.id.weather layout); 
titleCity = (TextView) findViewById(R.id.title city); 
titleUpdateTime = (TextView) findViewById(R.id.title update time); 
degreeText = (TextView) findViewById(R.id.degree text); 
weatherInfoText = (TextView) findViewById(R.id.weather info text); 
forecastLayout = (LinearLayout) findViewById(R.id.forecast layout); 
aqiText = (TextView) findViewById(R.id.aqi text); 


pm25Text 


= (TextView) findViewById(R.id.pm25 text); 


comfortText = (TextView) findViewById(R.id.comfort text); 

carWashText = (TextView) findViewById(R.id.car wash text); 

SportText = (TextView) findViewById(R.id.sport text); 

SharedPreferences prefs = PreferenceManager.getDefaultSharedPreferences 
(this); 

String weatherString = prefs.getString("weather", null); 

if (weatherString != null) { 
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// 有 缓存 时 直接 解析 天 气 数据 
Weather weather = Utility.handleweatherResponse(weatherString); 
showWeatherInfo (weather); 
} else { 
// 无 缓存 时 去 服务 器 查询 天 气 
String weatherId = getIntent().getStringExtra("weather id"); 
weatherLayout.setVisibility(View,.INVISIBLE); 
requestWeather (weatherTd); 


} 


/** 
* 根据 天 气 id 请 求 城市 天 气 信息 
*/ 

public void requestWeather(final String weatherId) { 


String weatherUrL = "http://guolin.tech/api/weather?cityid=" + 
weatherId + "&key=bc0418b57b2d4918819d3974ac1285d9"，; 
HttpUtil.sendOkHttpRequest(weatherUrl, new Callback() { 
@Override 
public void onResponse(Call call, Response response) throws IOException { 
final String responseText = response.body().string(); 
final Weather weather = Utility.handleWeatherResponse(responseText); 
runOnUiThread(new Runnable() { 
@Override 
public void run() { 
if (weather != null SS "ok".equals(weather.status)) { 
SharedPreferences.Editor editor = PreferenceManager. 
getDefaultSharedPreferences (WeatherActivity.this). 
edit(); 
editor.putString("weather", responseText); 
editor.apply() 
showWeatherIinfo (weather); 
} else { 
Toast.makeText (WeatherActivity.this, "获取 天 气 信息 失败 "， 
Toast .LENGTH_SHORT) .show() ; 


}); 
} 


@Override 
public void onFailure(Call call, IOException e) { 
e.printStackTrace(); 
runOnUiThread(new Runnable() { 
@Override 
public void run() { 
Toast.makeText (WeatherActivity.this, "获取 天 气 信息 失败 "， 
Toast.LENGTH SHORT).show(); 
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/沙沙 
六 处 理 并 展示 Weather 实体 类 中 的 数据 
7 
private void showWeatherInfo(Weather weather) { 
String cityName = weather.basic.cityName; 
String updateTime = weather.basic.update.updateTime.split(" ")[1]; 
String degree = weather.now.temperature + "°C"; 
String weatherInfo = weather.now.more.info; 
titleCity.setText (cityName); 
titleUpdateTime. setText (updateTime); 
degreeText .setText (degree); 
weatherInfoText.setText (weatherInfo); 
forecastLayout. removeAllViews(); 
for (Forecast forecast : weather,forecastList) { 
View view = LayoutInfLater.from(this).infLate(R.Layout.forecast 
item, forecastLayout, false); 
TextView dateText = (TextView) view.findViewById(R.id.date text); 
TextView infoText = (TextView) view.findViewById(R.id.info text); 
TextView maxText = (TextView) view.findViewById(R.id.max text); 
TextView minText = (TextView) view.findViewById(R.id.min text); 
dateText.setText(forecast.date); 
infoText.setText(forecast.more.info); 
maxText.setText(forecast.temperature.max); 
minText.setText(forecast.temperature.min); 
forecastLayout.addView(view); 
} 
if (weather.aqi != null) { 
aqiText.setText (weather.aqi.city,.aqi); 
pm25Text. setText (weather.aqi.city.pm25); 
} 
String comfort "舒适 度 : " + weather.suggestion.comfort.info; 
String carWash "洗车 指数 : " + weather.suggestion.carWash.info; 
String Sport = "运动 建议 : " + weather.suggestion.sport.info; 
ComfortText .setText(comfort) ; 
carWashText.setText (carWash); 
sportText.setText(sport); 
weatherLayout.setVisibility(View.VISIBLE); 


} 


这 个 活动 中 的 代码 也 比较 长 ， 我 们 还 是 一 步 步 梳理 下 。 在 onCreate() 方 法 中 仍然 先是 去 获 
取 一 些 控件 的 实例 ,然后 会 尝试 从 本 地 缓存 中 读 取 天 气 数据 。 那么 第 一 次 肯定 是 没有 缓存 的 ， 
此 就 会 从 Intent 中 取出 天 气 id, 并 调用 requestweather() 方 法 来 从 服务 器 请 求 天 气 数据 。 注意 ， 
请 求 数据 的 时 候 先 将 ScrollView 进行 隐藏 ， 不 然 空 数据 的 界面 看 上 去 会 很 奇怪 。 

requestWeather() 方 法 中 先是 使 用 了 参数 中 传人 的 天 气 id 和 我 们 之 前 申请 好 的 API Key 拼 装 
出 一 个 接口 地 址 ,接着 调用 HttpUtiL.send0kHttpRequest ( ) 方 法 来 向 该 地 址 发 出 请 求 ， 服 务 器 
会 将 相应 城市 的 天 气 信息 以 JSON 格式 返回 。 然 后 我 们 在 onResponse ( ) 回调 中 先 调用 Utility. 
handLeWeatherResponse() 方 法 将 返回 的 JSON 数据 转换 成 Weather 对 象 , 再 将 当前 线程 切换 到 
主线 程 。 然 后 进行 判断 ， 如 果 服 务 器 返回 的 status 状态 是 ok， 就 说 明 请 求 天 气 成 功 了 ， 此 时 将 返 
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回 的 数据 缓存 到 SharedPreferences 当中 ， 并 调用 showWeatherInfo() 方 法 来 进行 内 容 显 示 。 
showWeatherInfo() 方 法 中 的 逻辑 就 比较 简单 了 ， 其 实 就 是 从 Weather 对 象 中 获取 数据 ， 

然后 显示 到 相应 的 控件 上 。 注 意 在 未 来 几 天 天 和 气 预报 的 部 分 我 们 使 用 了 一 个 for 循环 来 处 理 每 天 

的 天 气 信息 ， 在 循环 中 动态 加 载 forecast item.xml 布局 并 设置 相应 的 数据 ， 然 后 添加 到 父 布局 当 


中 。 设 置 完 了 所 有 数据 之 后 ， 记 得 要 将 ScrollView 重新 变 成 可 见 。 


这 样 我 们 就 将 首次 进入 WeatherActivity 时 的 逻辑 全 部 梳理 完了 ， 那 么 当下 一 次 再 进入 


WeatherActivity 时 ， 由 于 缓存 已 经 存在 了 ， 因 此 会 直接 解析 并 显示 天 气 数据 ， 而 不 会 


络 请 求 了 。 


了 次 发 起 网 


处 理 完了 WeatherActivity 中 的 逻辑 , 接 下 来 我 们 要 做 的 , 就 是 如 何 从 省 市 县 列表 界面 跳 转 到 


天 气 界面 了 ， 修 改 ChooseAreaFragment 中 的 代码 ， 如 下 所 示 : 


public class ChooseAreaFragment extends Fragment { 


@Override 
public void onActivityCreated(Bundle savedInstanceState) { 
super.onActivityCreated(savedInstanceState); 


listView.setOnItemClickListener(new AdapterView.0nItemCLickListener() { 


@Override 


public void onItemClick(AdapterView<?> parent, View view, int position, 


long id) { 

if (currentLevel == LEVEL PROVINCE) { 
selectedProvince = provinceList.get(position); 
queryCities(); 

} else if (currentLevel == LEVEL CITY) { 
selectedCity = cityList.get(position); 
queryCounties(); 

} else if (currentLevel == LEVEL COUNTY) { 


String weatherId = countyList.get(position) .getWeatherId(); 
Intent intent = new Intent(getActivity(), WeatherActivity. 


class); 

intent.putExtra("weather_id", weatherId); 
startActivity(intent); 
getActivity().finish(); 


} 


非常 简单 ， 这 里 在 onItemClick() 方 法 中 加 入 了 一 个 if 判断 ， 如 果 当 前 级 别 是 LEVEL 


COUNTY， 就 启动 WeatherActivity， 并 把 当前 选中 县 的 天 气 id 传递 过 去 。 
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另外 ， 我 们 还 需要 在 MainActivity 中 加 入 一 个 缓存 数据 的 判断 才 行 。 修 改 MainActivity 中 的 
代码 ， 如 下 所 示 : 


public class MainActivity extends AppCompatActivity { 


GOverride 

protected void onCreate(Bundle savedInstanceState) { 
super.onCreate(savedInstanceState); 
setContentView(R.layout.activity main); 


SharedPreferences prefs = PreferenceManager.getDefaultSharedPreferences 
(this); 


if (prefs.getString("weather"”, null) != nuLL) { 


Intent intent = new Intent(this, WeatherActivity.class); 
startActivity(intent); 
finish(); 


} 


可 以 看 到 ， 这 里 在 onCreate() 方 法 的 一 开始 先 从 SharedPreferences 文件 中 读 取 缓存 数据 ， 
如 果 不 为 null 就 说 明之 前 已 经 请 求 过 天 气 数据 了 ， 那 么 就 没 必要 让 用 户 再 次 选择 城市 ， 而 是 直 
接 跳 转 到 WeatherActivity 即 可 。 


好 了 ， 现 在 重新 运行 一 下 程序 ， 然 后 选择 江苏 一 苏州 一 昆山 ， 结 果 如 图 14.21 所 示 。 
然后 我 们 还 可 以 向 下 滑动 查看 更 多 大气 信 息 ， 如 图 14.22 所 示 。 


YW 3:09 


Wi B 3:29 
22:51 


29°C 


2016-08-17 


2016-08-18 


预报 


2016-08-14 
2016-08-15 
2016-08-16 
2016-08-17 
2016-08-18 


2016-08-19 


图 14.21 显示 天 气 信 息 
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14.5.4 ”获取 必 应 每 日 一 图 

虽说 现在 我 们 已 经 把 天 气 界面 编写 得 非常 不 错 了 ， 不 过 和 市 场 上 的 一 些 天 气 软件 的 界面 相 
比 , 仍然 还 是 有 一 定 差距 的 。 出 色 的 天 气 软 件 不 会 像 我 们 现在 这 样 使 用 一 个 固定 的 背景 色 ， 而 是 
会 根据 不 同 的 城市 或 者 天 气 情况 展示 不 同 的 背景 图 片 。 

当然 实现 这 个 功能 并 不 复杂 , 最 重要 的 是 需要 有 服务 器 的 接口 支持 。 不 过 我 实在 是 没有 精力 
去 准备 这 样 一 套 完善 的 服务 器 接口 , 那么 为 了 不 让 我 们 的 天 气 界面 过 于 单调 , 这 里 我 准备 使 用 一 
个 巧妙 的 办 法 。 

必 应 想必 你 肯定 不 会 陌生 , 这 是 一 个 由 微软 开发 的 搜索 引擎 网 站 。 这 个 网 站 除了 提供 强大 的 
搜索 功能 之 外 ， 还 有 一 个 非常 有 特色 的 地 方 ， 就 是 它 每 天 都 会 在 首页 展示 一 张 精 美的 背景 图 片 ， 
如 图 14.23 所 示 。 


图 14.23” 必 应 的 首页 
片 都 是 由 必 应 精 挑 细 选 出 来 的 , 并 且 每 天 都 会 变化 ， 如 果 我 们 使 用 它们 来 作为 天 


由 于 这 些 
气 界 面 的 背景 图 ， 不 仅 可 以 让 界面 变 得 更 加 美观 ， 而 且 解 决 了 界面 一 成 不 变 、 过 于 单调 的 问题 。 

为 此 我 专门 准备 了 一 个 获取 必 应 每 日 一 图 的 接口 : http://guolin.tech/api/bing_pic。 

访问 这 个 接口 ， 服 务 需 会 返回 今日 的 必 应 背景 图 链接 : 

http://cn.bing.com/az/hprichbg/rb/ ChicagoHarborLH ZH-CN9974330969 1920x1080.jpg。 

然后 我 们 再 使 用 Glide 去 加 载 这 张 图 片 就 可 以 了 。 

总 体 思路 就 是 这 么 简单 ， 下 面 开 始 来 动手 实现 吧 。 首 先 修改 activity_weatherxml 中 的 代码 ， 
如 下 所 示 : 

<FrameLayout 


xmlns:android="http://schemas.android.com/apk/res/android" 
android:layout width="match parent" 


计 册 
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android:layout height="match parent" 
android:background="@color/colorPrimary"> 


<ImageView 
android:id="@+id/bing pic_img" 
android:layout width="match_parent" 
android:layout height="match parent" 
android:scaleType="centerCrop" /> 


<ScrollView 
android:id="@+id/weather layout" 
android:layout width="match parent" 
android:layout height="match parent" 
android:scrollbars="none" 
android:overScrollMode="never"> 


</ScrollView> 


</FrameLayout> 


这 里 我 们 在 FrameLayout 中 添加 了 一 个 ImnageView， 并 且 将 它 的 宽 和 高 都 设置 成 match_ 
parent。 由 于 FrameLayout 默认 情况 下 会 将 控件 都 放置 在 左上 角 ， 因 此 ScrollView 会 完全 覆盖 住 
ImageView， 从 而 ImageView 也 就 成 为 背景 图 片 了 。 


接着 修改 WeatherActivity 中 的 代码 ， 如 下 所 示 : 


public class WeatherActivity extends AppCompatActivity { 


private ImageView bingPicImg; 


@Override 

protected void onCreate(Bundle savedInstanceState) { 
super.onCreate(savedInstanceState); 
setContentView(R.layout.activity weather); 
// 初始 化 各 控件 
bingPicImg = (ImageView) findViewById(R.id.bing pic img); 


String bingPic = prefs.getString("bing pic", null); 
if (bingPic != null) { 
Glide.with(this).Tload(bingPic).into(bingPicImg); 
} else { 
loadBingPic(); 
} 
} 


/** 
* 根据 天 气 id 请 求 城市 天 气 信 息 
*/ 
public void requestWeather(final String weatherId) { 
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loadBingPic(); 
} 


/** 
六 加 载 必 应 每 日 一 图 
*/ 
private void loadBingPic() { 
String requestBingPic = "http://guolin.tech/api/bing pic"; 
HttpUtil.sendOkHttpRequest(requestBingPic, new Callback() { 
@Override 
public void onResponse(Call call, Response response) throws IOEXxception { 
final String bingPic = response.body().string(); 
SharedPreferences.Editor editor = PreferenceManager. 
getDefaultSharedPreferences (WeatherActivity.this) .edit(); 
editor.putString("bing pic", bingPic); 
editor.apply(); 
runOnUiThread(new Runnable() { 
@Override 
public void run() { 
GLide.with(WeatherActivity.this).Load(bingPic).into 
(bingPicImg); 


}); 
} 


@Override 
public void onFailure(Call call, I0OException e) { 
e.printStackTrace(); 


}); 


可 以 看 到 ， 首 先 在 onCreate() 方 法 中 获取 了 新 增 控件 ImageView 的 实例 ， 然 后 尝试 从 
SharedPreferences 中 读 取 缓存 的 背景 图 片 。 如 果 有 缓存 的 话 就 直接 使 用 Glide 来 加 载 这 张 图 片 ， 
如 果 没 有 的 话 就 调用 LoadBingPic() 方 法 去 请 求 今日 的 必 应 背景 图 。 

LoadBingPic() 方 法 中 的 逻辑 就 非常 简单 了 ,先是 调用 了 HttpUtit.send0kHttpRequest ( ) 
方法 获取 到 必 应 背景 图 的 链接 ,然后 将 这 个 链接 缓存 到 SharedPreferences 当中 ,再 将 当前 线程 切 
换 到 主线 程 ， 最 后 使 用 Glide 来 加 载 这 张 图 片 就 可 以 了 。 男 外 需要 注意 ,在 requestWeather() 
方法 的 最 后 也 需要 调用 一 下 LoadBingPic() 方 法 ， 这 样 在 每 次 请 求 天 气 信息 的 时 候 同 时 也 会 刷 
新 背景 图 片 。 现 在 重新 运行 一 下 程序 ， 效 果 如 图 14.24 所 示 。 
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2016-08-16 


2016-08-17 


图 14.24 在 天 气 界面 显示 必 应 背景 图 


怎么 样 ? 虽说 只 是 换 了 一 张 背景 图 而 已 , 但 是 整个 界面 的 视觉 体验 就 完全 不 一 样 了 , 瞬间 提 
升 了 好 几 个 档次 。 而 且 我 们 的 背景 图 并 不 是 一 成 不 变 的 , 每 天 都 会 是 不 同 的 图 片 ， 永远 给 人 一 种 
耳目 一 新 的 感觉 。 

不 过 如 果 你 仔细 观察 图 14.24， 你 会 发 现 背 景 图 并 没有 和 状态 栏 融合 到 一 起 , 这 样 的 话 视 觉 
体验 就 还 是 没有 达到 最 佳 的 效果 。 虽 说 我 们 在 12.7.2 小 节 已 经 学 习 过 如 何 将 背景 图 和 状态 栏 融 
合 到 一 起 ， 但 当时 是 借助 Design Support 库 完 成 的 ， 而 我 们 这 个 项 目 中 并 没有 引入 Design 
Support 库 。 

当然 如 果 还 是 模仿 12.7.2 小 节 的 做 法 , 引入 Design Support 库 , 然后 租 套 CoordinatorLayout、 
AppBarLayout、CollapsingToolbarLayonut 等 布局 ， 也 能 实现 背景 图 和 状态 栏 融 合 到 一 起 的 效果 ， 
不 过 这 样 做 就 过 于 麻烦 了 ， 这 里 我 准备 教 你 男 外 一 种 更 简单 的 实现 方式 。 修 改 WeatherActivity 
中 的 代码 ， 如 下 所 示 : 


public class WeatherActivity extends AppCompatActivity { 


GOverride 
protected void onCreate(Bundle savedInstanceState) { 
super.onCreate(savedInstanceState); 
if (Build.VERSION.SDK INT >= 21) { 
View decorView = getWindow() .getDecorView(); 
View.SYSTEM UI _ FLAG LAYOUT_ FULLSCREEN 
| View.SYSTEM UI FLAG LAYOUT_ STABLE); 
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getWindow().setStatusBarColor(Color.TRANSPARENT); 


setContentView(R.layout.activity weather); 


} 


由 于 这 个 功能 是 Android 5.0 及 以 上 的 系统 才 文 持 的 ， 因 此 我 们 先 在 代码 中 做 了 一 个 系统 版 
本 号 的 判断 ， 只 有 当 版 本 号 大 于 或 等 于 21， 也 就 是 5.0 及 以 上 系统 时 才 会 执行 后 面 的 代码 。 

接着 我 们 调用 了 getWindow() .getDecorView() 方 法 拿 到 当前 活动 的 DecorView , 再 调用 它 
的 setSystemUiVisibility() 方 法 来 改变 系统 UI 的 显示 ， 这 里 传人 View.SYSTEM UI 
FLAG_LAYOUT_FULLSCREEN 和 View.SYSTEM_UI FLAG_LAYOUT_STABLE 就 表示 活动 的 布局 会 显 
示 在 状态 栏 上 面 ， 最 后 调用 一 下 setStatusBarColor() 方 法 将 状态 栏 设 置 成 透明 色 。 

仅仅 这 些 代码 就 可 以 实现 让 背景 图 和 状态 栏 融 合 到 一 起 的 效果 了 。 不 过 , 如 果 运 行 一 下 程序 ， 
你 会 发 现 还 是 有 些 问题 ， 天 气 界面 的 头 布局 几乎 和 系统 状态 栏 紧 贴 到 一 起 了 ， 如 图 14.25 所 示 。 


2016-08-15 


2016-08-16 


图 14.25” 头 布局 和 状态 栏 紧 贴 在 一 起 
这 是 由 于 系统 状态 栏 已 经 成 为 我 们 布局 的 一 部 分 ， 因此 没有 单独 为 它 留 出 空间 。 当 然 , 这 个 
问题 也 是 非常 好 解决 的 ， 借 助 android:fitsSystemWindows 属性 就 可 以 了 。 修 改 activity_ 
weatherxml 中 的 代码 ， 如 下 所 示 : 
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<FrameLayout 


xmlns:android="http://schemas.android.com/apk/res/android" 
android:layout width="match parent" 

android:layout height="match parent" 
android:background="@color/colorPrimary"> 


<ScrollView 


android: 
android: 
android: 
android: 
android: 


id="@+id/weather layout" 
layout width="match parent" 
layout height="match parent" 
scrollbars="none" 
overScrollMode="never"> 


<LinearLayout 
android:orientation="vertical" 
android:layout width="match parent" 
android:layout height="wrap content" 
android:fitsSystemWindows="true"> 


</LinearLayout> 


</ScrollView> 


</FrameLayout> 


这 里 在 ScrollView 的 LinearLayout 中 增加 了 android:fitsSystemWindows 属性 ,设置 成 
true 就 表示 会 为 系统 状态 栏 留 出 空间 。 现 在 重新 运行 一 下 代码 ， 效 果 如 图 14.26 所 示 。 


2016-08-17 


2016-08-18 


图 14.26 ”为 系统 状态 栏 留 出 空间 
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OK， 这 样 第 三 阶段 的 开发 工作 也 都 完成 了 ， 我 们 把 代码 提交 一 下 。 


git add . 
git commit -m "加 入 显示 天 气 信 息 的 功能 。" 
git push origin master 
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经 过 第 三 阶段 的 开发 , 现在 酷 欧 天 气 的 主体 功能 已 经 有 了 , 不 过 你 会 发 现 目前 存在 着 一 个 比 
较 严重 的 bug， 就 是 当 你 选中 了 某 一 个 城市 之 后 ， 就 没 法 再 去 查看 其 他 城市 的 天 气 了 ， 即 使 退出 
程序 ， 下 次 进来 的 时 候 还 会 直接 跳 转 到 WeatherActivity。 

因此 , 在 第 四 阶段 中 我 们 要 加 入 切换 城市 的 功能 , 并且 为 了 能 够 实时 获取 到 最 新 的 天 气 , 我 
们 还 会 加 入 手动 更 新 天 气 的 功能 。 


14.6.1 手动 更 新 天 气 


先 来 实现 一 下 手动 更 新 天 气 的 功能 。 由 于 我 们 在 上 一 节 中 对 天 气 信息 进行 了 缓存 ,目前 每 次 
展示 的 都 是 缓存 中 的 数据 ， 因 此 现在 非常 需要 一 种 方式 能 够 让 用 户 手动 更 新 天 气 信息 。 

至 于 如 何 触发 更 新 事件 呢 ? 这 里 我 准备 采用 下 拉 刷 新 的 方式 , 正好 我 们 之 前 也 学 过 下 拉 刷 新 
的 用 法 ， 实 现 起 来 会 比较 简单 。 

首先 修改 activity_ weatherxml 中 的 代码 ， 如 下 所 示 : 


<FrameLayout 
xmlns:android="http://schemas.android.com/apk/res/android" 
android:layout width="match parent" 
android:layout height="match parent" 
android:background="@color/colorPrimary"> 


<android.support.v4.widget.SwipeRefreshLayout 
android:id="@+id/swipe_refresh" 
android:Tlayout width="match_parent" 
android:layout height="match parent"> 


<ScrollView 
android:id="@+id/weather layout" 
android:layout width="match parent" 
android:layout height="match parent" 
android:scrollbars="none" 
android:overScrollMode="never"> 


</ScrollView> 
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</android. support .v4.widget .SwipeRefreshLayout> 


</FrameLayout> 


可 以 看 到 ， 这 里 在 ScrollView 的 外 面 又 租 套 了 一 层 SwipeRefreshLayout， 这 样 ScrollView 就 
自动 拥有 下 拉 刷 新 功能 了 。 


然后 修改 WeatherActivity 中 的 代码 ， 加 入 更 新 天 气 的 处 理 逻 辑 ， 如 下 所 示 


public class WeatherActivity extends AppCompatActivity { 


public SwipeRefreshLayout swipeRefresh; 
private String mWeatherId; 


GOverride 
protected void onCreate(Bundle savedInstanceState) { 
super.onCreate(savedInstanceState); 


swipeRefresh = (SwipeRefreshLayout) findViewById(R.id.swipe refresh); 
swipeRefresh.setColorSchemeResources(R.color.colorPrimary); 
SharedPreferences prefs = PreferenceManager. 
getDefaultSharedPreferences (this); 
String weatherString = prefs.getString("weather", null); 
if (weatherString != null) { 
// 有 缓存 时 直接 解析 天 气 数据 
Weather weather = Utility.handleWeatherResponse(weatherString); 
mWeatherId = weather.basic.weatherId; 
showWeatherInfo (weather); 
} else { 
// 无 缓存 时 去 服务 器 查询 天 气 
mWeatherId = getIntent() .getStringExtra("weather_ id"); 
weatherLayout.setVisibility(View.INVISIBLE); 
requestWeather (mWeatherId); 
} 
swipeRefresh.setOnRefreshListener(new SwipeRefreshLayout. 
OnRefreshListener() { 
@Override 
public void onRefresh() { 
requestWeather (mWeatherId); 
} 
}); 
} 


/沙沙 
根据 天 气 id 请 求 城市 天 气 信 息 

*/ 

public void requestWeather(final String weatherId) { 


String weatherUrl = "http://guolin.tech/api/weather?cityid=" + 
weatherId + "&key=bc0418b57b2d4918819d3974ac1285d9"; 
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HttpUtil.sendOkHttpRequest(weatherUrl, new Callback() { 
@Override 
public void onResponse(Call call, Response response) throws IOException { 


runOnUiThread(new Runnable() { 
@Override 
public void run() { 
if (weather != nuLL SS "ok".equals(weather.status)) { 
SharedPreferences.Editor editor = PreferenceManager. 
getDefaultSharedPreferences (WeatherActivity. 
this).edit(); 
editor.putString("weather", responseText); 
editor.apply() 
mWeatherId = weather.basic.weatherId ; 
showWeatherIinfo (weather); 
} else { 
Toast.makeText (WeatherActivity.this, "获取 天 气 信息 失败 "， 
Toast .LENGTH SHORT).show(); 
} 
swipeRefresh.setRefreshing(false); 


}); 
} 


@Override 
public void onFailure(Call call, IOException e) { 
e.printStackTrace(); 
runOnUiThread(new Runnable() { 
@Override 
public void run() { 
Toast.makeText (WeatherActivity.this, "获取 天 气 信息 失败 "， 
Toast .LENGTH_SHORT) .show() ; 
swipeRefresh.setRefreshing(false); 


}); 
} 
}); 
loadBingPic(); 


} 


修改 的 代码 并 不 算 多 ， 首先 在 onCreate() 方 法 中 获取 到 了 SwipeRefreshLayout 的 实例 ， 然 
后 调用 setCotLorSchemeResources ( ) 方 法 来 设置 下 拉 刷 新 进度 条 的 颜色 ,这 里 我 们 就 使 用 主题 
中 的 colorPrimary 作为 进度 条 的 颜色 了 。 接 着 定义 了 一 个 mweatherId 变量 ， 用 于 记录 城市 的 天 
气 id， 然 后 调用 set0nRefreshListener() 方 法 来 设置 一 个 下 拉 刷 新 的 监听 器 ， 当 触发 了 下 拉 刷 
新 操作 的 时 候 , 就 会 回调 这 个 监听 器 的 onRefresh() 方 法 , 我 们 在 这 里 去 调用 requestWeather() 
方法 请 求 天 气 信息 就 可 以 了 。 

另外 不 要 忘记 ， 当 请 求 结束 后 ， 还 需要 调用 SwipeRefreshLayout 的 setRefreshing () 方 法 
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并 传人 fatse， 用 于 表示 刷新 事件 结束 ， 并 隐藏 刷新 进度 条 。 
现在 重新 运行 一 下 程序 ， 并 在 屏幕 的 主 界面 向 下 拖 动 ， 效 果 如 图 14.27 所 示 。 


图 14.27 手动 更 新 天 气 
更 新 完 天 气 信息 之 后 ， 下 拉 进 度 条 会 自动 消失 。 


14.6.2 ”切换 城市 
完成 了 手动 更 新 天 气 的 功能 ， 接 下 来 我 们 继续 实现 切换 城市 功能 。 


既然 是 要 切换 城市 ， 那 么 就 肯定 需要 遍历 全 国 省 市 县 的 数据 ， 而 这 个 功能 我 们 早 在 14.4 节 
就 已 经 完成 了 ,并 且 当 时 考虑 为 了 方便 后 面 的 复 用 ,特意 选择 了 在 碎片 当中 实现 。 因 此 , 我 们 其 
实 只 需要 在 天 气 界面 的 布局 中 引入 这 个 碎片 ， 就 可 以 快速 集成 切换 城市 功能 了 。 


虽说 实现 原理 很 简单 , 但 是 显然 我 们 也 不 可 能 让 引入 的 碎片 把 天 气 界 面 遮 挡住 , 这 又 该 怎么 
办 呢 ? 还 记得 12.3 节 学 过 的 滑动 菜单 功能 吗 ? 将 碎片 放 入 到 滑动 菜单 中 真是 再 合适 不 过 了 ， 正 
常情 况 下 它 不 占据 主 界面 的 任何 空间 , 想 要 切换 城市 的 时 候 只 需要 通过 滑动 的 方式 将 菜单 显示 出 
来 就 可 以 了 。 

下 面 我 们 就 按照 这 种 思路 来 实现 。 首 先 按照 Material Design 的 建议 , 我 们 需要 在 头 布局 中 加 
和信 一 个 切换 城市 的 按钮 ， 不 然 的 话 用 户 可 能 根本 就 不 知道 屏幕 的 左 侧 边缘 是 可 以 拖 动 的 。 修 改 
title.xml 中 的 代码 ， 如 下 所 示 : 

<RelativeLayout 


xmlns:android="http://schemas.android.com/apk/res/android" 
android:layout width="match parent" 
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android:layout height="?attr/actionBarSize"> 


<Button 
android:id="@+id/nav_button" 
android:layout width="30dp" 
android:layout height="30Qdp" 
android:layout marginLeft="10dp" 
android:1layout alignParentLeft="true" 
android:Tlayout_centerVertical="true" 
android:background="@drawable/ic home" /> 


</RelativeLayout> 


这 里 添加 了 一 个 Button 作为 切换 城市 的 按钮 ， 并 且 让 它 居 左 显示 。 另 外 ， 我 提前 准备 好 了 
一 张 图 片 来 作为 按钮 的 背景 图 。 


接着 修改 activity_weather.xml 布局 来 加 入 滑动 菜单 功能 ， 如 下 所 示 : 


<FrameLayout 
xmlns:android="http://schemas.android.com/apk/res/android" 
android:layout width="match parent" 
android:layout height="match parent" 
android:background="@color/colorPrimary"> 


<android.support.v4.widget.DrawerLayout 
android:id="@+id/drawer_ layout" 
android:layout width="match_ parent" 
android:layout height="match parent"> 


<android.support.v4.widget.SwipeRefreshLayout 
android:id="@+id/swipe refresh" 
android:layout width="match parent" 
android:layout height="match parent"> 


</android.support.v4.widget.SwipeRefreshLayout> 


<fragment 
android:id="@+id/choose area fragment" 
android:name="com.coolweather .android.ChooseAreaFragment" 
android:layout width="match_parent" 
android:layout height="match parent" 
android:layout gravity="start" 
/> 


</android.support.v4.widget.DrawerLayout> 


</FrameLayout> 
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可 以 看 到 ， 我 们 在 SwipeRefreshLayout 的 外 面 义 和 角 套 了 一 层 DrawerLayout。DrawerLayout 
中 的 第 一 个 子 控件 用 于 作为 主屏 幕 中 显示 的 内 容 ， 第 二 个 子 控件 用 于 作为 滑动 菜单 中 显示 的 内 
容 ， 因 此 这 里 我 们 在 第 二 个 子 控 件 的 位 置 添加 了 用 于 遍历 省 市 县 数据 的 碎片 。 

接 下 来 需要 在 WeatherActivity 中 加 入 滑动 菜单 的 逻辑 处 理 ， 修 改 WeatherActivity 中 的 代码 ， 
如 下 所 示 : 


public class WeatherActivity extends AppCompatActivity { 


public DrawerLayout drawerLayout; 


private Button navButton; 


@Override 
protected void onCreate(Bundle savedInstanceState) { 
super.onCreate(savedInstanceState); 


drawerLayout = (DrawerLayout) findViewById(R.id.drawer layout); 
navButton = (Button) findViewById(R.id.nav_button) ; 


navButton.setOnClickListener(new View.0nCLickListener() { 
@Override 
public void onClick(View v) { 
drawerLayout .openDrawer (GravityCompat .START) ; 
} 
}); 


} 


很 简单 ， 首 先 在 onCreate() 方 法 中 获取 到 新 增 的 DrawerLayout 和 Button 的 实例 ， 然 后 在 
Button 的 点 击 事件 中 调用 DrawerLayout 的 openD rawer( ) 方 法 来 打开 滑动 荣 单 就 可 以 了 。 

不 过 现在 还 没有 结束 , 因为 这 仅仅 是 打开 了 滑动 菜单 而 已 , 我 们 还 需要 处 理 切换 城市 后 的 逻 
辑 才 行 。 这 个 工作 就 必须 要 在 ChooseAreaFragment 中 进行 了 ， 因 为 之 前 选中 了 某 个 城市 后 是 跳 
转 到 WeatherActivity 的 , 而 现在 由 于 我 们 本 来 就 是 在 WeatherActivity 当中 的 ,因此 并 不 需要 跳 转 ， 
只 是 去 请 求 新 选择 城市 的 天 气 信息 就 可 以 了 。 

那么 很 显然 这 里 我 们 需要 根据 ChooseAreaFragment 的 不 同 状 态 来 进行 不 同 的 逻辑 处 
改 ChooseAreaFragment 中 的 代码 ， 如 下 所 示 : 


public class ChooseAreaFragment extends Fragment { 


[T= 
一 
NS 


GOverride 
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public void onActivityCreated(Bundle savedInstanceState) { 
super.onActivityCreated(savedInstanceState); 
listView.setOnItemClickListener(new AdapterView.OnItemClickListener() { 


@Override 
public void onItemClick(AdapterView<?> parent, View view, int position, 
Long id) { 


if (currentLevel == LEVEL PROVINCE) { 
selectedProvince = provinceList.get(position); 
queryCities(); 

} else if (currentLevel == LEVEL CITY) { 
selectedCity = cityList.get(position); 
queryCounties(); 

} else if (currentLevel == LEVEL COUNTY) { 

String weatherId = CountyList.get(position) ,getwWeatherId() ; 

if (getActivity() instanceof MainActivity) { 

Intent intent = new Intent(getActivity(), WeatherActivity. 
class); 

intent.putExtra("weather id", weatherId); 

startActivity(intent); 

getActivity().finish(); 

} else if (getActivity() instanceof WeatherActivity) { 
WeatherActivity activity = (WeatherActivity) getActivity(); 
activity.drawerLayout .closeDrawers(); 
activity. swipeRefresh.setRefreshing(true); 
activity.requestWeather (weatherId); 


} 


这 里 我 使 用 了 一 个 Java 中 的 小 技巧 , instanceof 关键 字 可 以 用 来 判断 一 个 对 象 是 否 属于 某 
个 类 的 实例 。 我 们 在 碎片 中 调用 getActivity() 方 法 ， 然 后 配合 instanceof 关键 字 ， 就 能 轻 
松 判断 出 该 雄 片 是 在 MainActivity 当中 ， 还 是 在 WeatherActivity 当中 。 如 果 是 在 MainActivity 当 
中 ,那么 处 理 逻 辑 不 变 。 如 果 是 在 WeatherActivity 当中 ,那么 就 关闭 滑动 菜单 ， 显 示 下 拉 刷 新 进 
度 条 ， 然 后 请 求 新 城市 的 天 气 信息 。 


这 样 我 们 就 把 切换 城市 的 功能 全 部 完成 了 , 现在 可 以 重新 运行 一 下 程序 , 效果 如 图 14.28 所 示 。 


三 
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图 14.28 ”拥有 切换 城市 按钮 的 天 气 界面 


可 以 看 到 , 标题 栏 上 多 出 了 一 个 用 于 切换 城市 的 按钮 。 点 击 该 按钮 ， 或 者 在 屏幕 的 左 侧 边缘 
进行 拖 动 ， 就 能 让 滑动 菜单 界面 显示 出 来 了 ， 如 图 14.29 所 示 。 


图 14.29 


显示 滑动 菜单 界面 


然后 我 们 就 可 以 在 这 里 切换 其 他 城市 了 
的 天 气 信息 也 会 更 新 成 你 选择 的 那个 城市 。 


。 选中 城市 之 后 滑动 菜单 会 自动 关闭 , 并 且 主 界面 上 
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这 样 ， 第 四 阶段 的 开发 任务 也 完成 了 。 当 然 ， 仍 然 不 要 忘记 提交 代码 。 
git add . 


git com 
git pus 


14.7 后 


mit -m "新 增 切 换 城 市 和 手动 更 新 天 气 的 功能 。" 
h origin master 


台 自 动 更 新 天 气 


et 


为 了 要 让 酪 欧 天 气 更 加 智能 , 在 第 五 阶段 我 们 准备 加 入 后 台 自 动 更 新 天 气 的 功能 , 这 样 就 可 
以 尽 可 能 地 保证 用 户 每 次 打开 软件 时 看 到 的 都 是 最 新 的 天 气 信息 。 

要 想 实现 上 述 功能 ,就 需要 创建 一 个 长 期 在 后 台 运 行 的 定时 任务 ,这 个 功能 肯定 是 难 不 倒 你 
的 ， 因 为 我 们 在 13.5 市 中 就 已 经 学 习 过 了 。 


首先 在 


service 包 下 新 建 一 个 服务 ， 右 击 com.coolweather.android.service 一 New 一 Service 一 


Service， 创 建 一 个 AutoUpdateService， 并 将 Exported 和 Enabled 这 两 个 属性 都 勾 中 。 然 后 修改 


AutoUpdateS 
public 


ervice 中 的 代码 ， 如 下 所 示 : 


class AutoUpdateService extends Service { 


@Override 
public IBinder onBind(Intent intent) { 


} 


return null; 


@Override 
public int onStartCommand(Intent intent, int flags, int startId) { 


} 


updateWeather(); 

updateBingPic(); 

AlarmManager manager = (AlarmManager) getSystemService(ALARM SERVICE); 
int anHour = 8 * 60 * 60 * 1000; // 这 是 8 小 时 的 毫秒 数 

Long triggerAtTime = SystemClock.elapsedRealtime() + anHour; 

Intent i = new Intent(this, AutoUpdateService.class); 

PendingIntent pi = PendingIntent.getService(this, 0, i, 0); 
manager.cancel (pi); 

manager.set(AlarmManager.ELAPSED REALTIME WAKEUP, triggerAtTime, pi); 
return super.onStartCommand(intent, flags, startId); 


/** 


* 


更 新 天 气 信 息 


WA 
private void updateweather(){ 


SharedPreferences prefs = PreferenceManager.getDefaultSharedPreferences (this); 
String weatherString = prefs.getString("weather", null); 
if (weatherString != null) { 

// 有 缓存 时 直接 解析 天 气 数据 

Weather weather = UtiLity.handLeweatherResponse(weatherSstring) ; 

String weatherId = weather.basic,weatherId ; 


String weatherUrL = "http://guolin.tech/api/weather?cityid=" + 
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weatherId + "&key=bc0418b57b2d4918819d3974ac1285d9"，; 
HttpUtil.sendOkHttpRequest(weatherUrl, new Callback() { 
@Override 
public void onResponse(Call call, Response response) throws 
IOException { 
String responseText = response.body().string(); 
Weather weather = Utility.handleweatherResponse(responseText); 
if (weather != null SS "ok".equals(weather.status)) { 
SharedPreferences.Editor editor = PreferenceManager. 
getDefaultSharedPreferences(AutoUpdateService.this). 
edit(); 
editor.putString("weather", responseText); 
editor.apply() 


} 


@Override 
public void onFailure(Call call, IOException e) { 
e.printStackTrace(); 


} 
}); 
} 
} 
/沙沙 
* 更 新 必 应 每 日 一 图 
*/ 


private void updateBingPic() { 
String requestBingPic = "http://guolin.tech/api/bing pic"; 
HttpUtil.sendOkHttpRequest(requestBingPic, new Callback() { 


@Override 
public void onResponse(Call call, Response response) throws IOException { 


String bingPic = response.body().string(); 
SharedPreferences.Editor editor = PreferenceManager.getDefault 
SharedPreferences(AutoUpdateService.this).edit(); 
editor.putString("bing pic", bingPic); 
editor.apply(); 
} 


@Override 
public void onFailure(Call call, IOException e) { 
e.printStackTrace(); 


} 

可 以 看 到 ,在 onStartCommand() 方 法 中 先是 调用 了 updateWeather() 方 法 来 更 新 天 气 ， 
然后 调用 了 updateBingPic() 方 法 来 更 新 背景 图 片 。 这 里 我 们 将 更 新 后 的 数据 直接 存储 到 
SharedPreferences 文件 中 就 可 以 了 ,因为 打开 WeatherActivity 的 时 候 都 会 优先 从 SharedPreferences 
绥 存 中 读 取 数 据 。 
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之 后 就 是 我 们 学 习 过 的 创建 定时 任务 的 技巧 了 , 为 了 保证 软件 不 会 消耗 过 多 的 流量 , 这 里 将 
时 间 间 隔 设置 为 8 小 时 , 8 小 时 后 AutoUpdateReceiver 的 onStartCommand() 方 法 就 会 重新 执行 ， 
这 样 也 就 实现 后 台 定 时 更 新 的 功能 


不 过 , 我 们 还 需要 在 代码 某 处 去 激活 AutoUpdateService 这 个 服务 才 行 。 修改 WeatherActivity 
中 的 代码 ， 如 下 所 示 : 


public class WeatherActivity extends AppCompatActivity { 


/** 


* 处 理 并 展示 Weather 实体 类 中 的 数据 。 
*/ 
private void showWeatherInfo(Weather weather) { 


weatherLayout.setVisibility(View.VISIBLE); 


Intent intent = new Intent(this, AutoUpdateService.class); 
startService(intent); 


} 


可 以 看 到 , 这 里 在 showWeatherInfo() 方 法 的 最 后 加 入 启动 AutoUpdateService 这 个 服务 的 
代码 , 这 样 只 要 一 旦 选中 了 某 个 城市 并 成 功 更 新 天 气 之 后 , AutoUpdateService 就 会 一 直 在 后 台 运 
行 ， 并 保证 每 8 小 时 更 新 一 次 天 气 。 

现在 可 以 再 提交 一 下 代码 : 

git add . 


git commit -m "增加 后 人 台 自 动 更 新 天 气 的 功能 。" 
git push origin master 


14.8 ”修改 图 标 和 名 称 
目前 的 酷 欧 天 气 看 起 来 还 不 太 像 是 一 个 正式 的 软件 , 为 什么 呢 ? 因为 都 还 没有 一 个 像样 的 图 
标 呢 。 一 直 使 用 Android Studio 自动 生成 的 图 标 确 实 不 太 合适 ， 是 时 候 需 要 换 一 下 了 。 


这 里 我 事先 准备 好 了 一 张 图 片 来 作为 软件 图 标 ,， 由 于 我 也 不 是 搞 美 术 的 , 因此 图 标 设计 得 非 
常 简 单 ， 如 图 14.30 所 示 。 


图 14.30“” 酷 欧 天 气 的 图 标 


14.9 ”你 还 可 以 做 的 事情 543 


理论 上 来 讲 , 我 们 应 该 给 这 个 图 标 提供 几 种 不 同 分 辨 率 的 版 本 , 然后 分 别 放 和 人 到 相应 分 辩 率 
的 mipmap 目录 下 ， 这 里 简单 起 见 ， 我 就 都 使 用 同一 张 图 了 。 将 这 张 图 片 命名 成 logo.png， 放 入 
到 所 有 以 mipmap 开头 的 目录 下 ， 然 后 修改 AndroidManifest.xml 中 的 代码 ， 如 下 所 示 : 


<manifest xmlns:android="http://schemas.android.com/apk/res/android" 
package="com.coolweather.android"> 


<uses-permission android:name="android.permission.INTERNET" /> 


<application 
android:name="org.litepal .LitePalApplication" 
android:allowBackup="true" 
android:icon="Gmipmap/Logo" 
android:label="@string/app_name" 
android:supportsRtl="true" 
android:theme="@style/AppTheme"> 


</application> 


</manifest> 


这 里 将 <appLication> 标 签 的 android:icon 属性 指定 成 @mipmap/logo 就 可 以 修改 程序 图 
标 了 。 接 下 来 我 们 还 需要 修改 一 下 程序 的 名 称 ， 打 开 res/values/string.xml 文件 ， 其 中 app_name 
对 应 的 就 是 程序 名 称 ， 将 它 修 改 成 酷 欧 天 气 即 可 ， 如 下 所 示 : 


<resources> 
<string name="app_name"> 酷 欧 天 气 </string> 
</resources> 


现在 重新 运行 一 遍 程 序 ， 这 时 观察 酷 欧 天 气 的 桌面 图 标 ， 如 图 14.31 所 示 。 


4 字 口 


Phone 


图 14.31 手机 桌面 图 标 


养 成 良好 的 习惯 ， 仍 然 不 要 忘记 提交 代码 。 
git add ， 


git commit -m "修改 程序 图 标 和 名 称 。" 
git push origin master 


这 样 我 们 就 终于 大 功 告 成 了 ! 
14.9 ”你 还 可 以 做 的 事情 


经 过 五 个 阶段 的 开发 ， 酷 欧 天 气 已 经 是 一 个 完善 、 成 熟 的 软件 了 吗 ? 嘿嘿 ， 还 差 得 远 呢 ! 现 
在 的 酷 欧 天 气 只 能 说 是 具备 了 ss 本 的 功能 ， 和 那些 商用 的 天 气 软件 比 起 来 还 有 很 大 的 差 
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距 ， 因 此 你 仍然 还 有 非常 巨大 的 发 挥 空间 来 对 它 进 行 完善 。 

比如 说 以 下 功能 是 你 可 以 考虑 加 入 到 酷 欧 天 气 中 的 。 

口 增加 设置 选项 ， 证 用 户 选择 是 和 否 允许 后 台 自 动 更 新 天 气 ， 以 及 设 定 更 新 的 频率 。 

口 优化 软件 界面 ， 提 供 多 套 与 天 气 对 应 的 图 片 ， 让 程序 可 以 根据 不 同 的 天 气 自 动 切换 背景 
图 。 

口 允许 选择 多 个 城市 ， 可 以 同时 观察 多 个 城市 的 天 气 信息 ， 不 用 来 回 切 换 。 

口 提供 更 加 完整 的 天 气 信息 ， 目 前 我 们 只 使 用 了 和 风 天 气 返回 的 一 小 部 分 数据 而 已 。 
另外 ， 由 于 酷 欧 天 气 的 源码 已 经 托管 在 了 GitHub 上 面 ， 如 果 你 想 在 现 有 代码 的 基础 上 继续 

对 这 个 项 目 进 行 完 善 ， 就 可 以 使 用 GitHub 的 Fork 功能 。 
首先 登录 你 自己 的 GitHub 账号 , 然后 打开 酷 欧 天 气 版 本 库 的 主页 : https://github.com/guolindev/ 

coolweather， 这 时 在 页 面 头 部 的 最 右 侧 会 有 一 个 Fork 按钮 ， 如 图 14.32 所 示 。 


人 watchv 0 食 Star 0 ¥Fork 0 


图 14.32” GitHub Fork 按钮 


点 击 一 下 Fork 按钮 就 可 以 将 酷 欧 天 气 这 个 项 目 复 制 一 份 到 你 的 账号 下 ， 青 使 用 git clone 
命令 将 它 克隆 到 本 地 ， 然 后 你 就 可 以 在 现 有 代码 的 基础 上 随心 所 欲 地 添加 任何 功能 并 提交 了 。 


~ 


15 章 


贡 | 浇 


后 一 步 一 一 将 应 用 发 布 到 360 应 用 商店 


应 用 已 经 开发 出 来 了 , 下 一 步 我 们 需要 思考 推广 方面 的 工作 。 那么 如 何 才 能 让 更 多 的 用 户 知 
道 并 使 用 我 们 的 应 用 程序 呢 ? 在 手机 领域 , 最 常见 的 做 法 就 是 将 程序 发 布 到 某 个 应 用 商店 中 , 这 
样 用 户 就 可 以 通过 商店 找到 我 们 的 应 用 程序 ， 然 后 轻松 地 进行 下 载 和 安装 。 

说 到 应 用 商店 ,在 Android 领 域 真 的 可 以 称 得 上 是 百家争鸣 ,除了 谷歌 官方 推出 的 Google Play 
之 外 ， 在 中 国 还 有 像 360、 豌 豆荚、 百度、 应 用 宝 等 知名 的 应 用 商店 。 当 然 ， 这些 商 店 所 提供 的 
功能 都 是 比较 类 似 的 ， 发 布 应 用 的 方法 也 大 同 小 异 ， 因 此 这 里 我 们 就 只 学 习 如 何 将 应 用 发 布 到 
360 应 用 商店 ， 其 他 应 用 商店 的 发 布 方法 相信 你 完全 可 以 自己 摸索 出 来 。 


15.1 生成 正式 签名 的 APK 文件 


之 前 我 们 一 直 都 是 通过 Android Studio 来 将 程序 安装 到 手机 上 的 ， 而 它 背 后 实际 的 工作 流程 
是 ，Android Studio 会 将 程序 代码 打包 成 一 个 APK 文件 ， 然 后 将 这 个 文件 传输 到 手机 上 ， 最 后 再 
执行 安装 操作 。Android 系统 会 将 所 有 的 APK 文件 识别 为 应 用 程序 的 安装 包 ， 类 似 于 Windows 
系统 上 的 EXE 文件 。 

但 并 不 是 所 有 的 APK 文件 都 能 成 功 安装 到 手机 上 ，Android 系统 要 求 只 有 签名 后 的 APK 文 
件 才 可 以 安装 ， 因 此 我 们 还 需要 对 生成 的 APK 文件 进行 签名 才 行 。 那 么 你 可 能 会 有 疑问 了 ， 直 
接 通 过 Android Studio 来 运行 程序 的 时 候 好 像 并 没有 进行 过 签名 操作 啊 ， 为 什么 还 能 将 程序 安装 
到 手机 上 呢 ? 这 是 因为 Android Studio 使 用 了 一 个 默认 的 keystore 文件 帮 有 我 们 自动 进行 了 签名 。 
点 击 Android Studio 右 侧 工具 栏 的 Gradle 一 项 目 名 一 :app 一 Tasks 一 android， 双 击 signingReport， 
结果 如 图 15.1 所 示 。 


Variant: debug 
Config: debug 
Store: C:\Users\Administrator\. android\debug. keystore 


图 15.1 查看 默认 的 keystore 文件 
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也 就 是 说 ， 我 们 所 有 通过 Android Studio 来 运行 的 程序 都 是 使 用 了 这 个 debug.keystore 文 
件 来 进行 签名 的 。 不 过 这 仅仅 适用 于 开发 阶段 而 已 ， 现 在 酷 欧 天 气 已 经 快要 发 布 了 ， 要 使 用 一 
个 正式 的 keystore 文件 来 进行 签名 才 行 。 下 面 我 们 就 来 学 习 一 下 ， 如 何 生 成 一 个 带 有 正式 签名 
的 APK 文件 。 


15.1.1 使 用 Android Studio 生成 

先 学 习 一 下 如 何 使 用 Android Studio 来 生成 正式 签名 的 APK 文件 。 点 击 Android Studio 导航 
栏 上 的 Build 一 Generate Signed APK, 首次 点 击 可 能 会 提示 让 我 们 输入 操作 系统 的 密码 , 如 图 15.2 
所 示 。 


Eo 


Master password is required 


to unlock the password database. 


The password database will be unlocked during this session 
for all subsystems. 


Requested by: Keystore Step 


Lee) WY [ee [aa 


图 15.2 输入 操作 系统 密码 提示 框 


输入 密码 之 后 点 击 OK， 则 会 弹出 如 图 15.3 所 示 的 创建 签名 APK 对 话 框 。 
二 MD Generate Signed APK (Ex) 
Key store path: | | 
| Greate new.. | | Choose existing.. | 


Key store password: 


Key alias: |] 


Key password: 


口 Remember passwords 


[ ou | EE | ere [|_ Help | 
J 


图 15.3 ”创建 签名 APK 对 话 框 


由 于 目前 我 们 还 没有 一 个 正式 的 keystore 文件 ， 所 以 应 该 点 击 Create new 按钮 ， 然 后 会 弹出 
一 个 新 的 对 话 框 来 让 我 们 填写 创建 keystore 文件 所 必要 的 信息 。 根据 自己 的 实际 情况 进行 填写 就 
行 了 ， 如 图 15.4 所 示 。 
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MW New Key Store Ex) 
Key store path: | C\Users\Administrator\Documents\guolinjks 图 
Bassword: | 
Key 

Alias: guolindev 

Password: | | 
vaidiy years: | 30 加 

-Certificate 


Eirst and Last Name: | Guo Lin 


Organizational Unit: | Personal 


Organization: Guo Lin 
City or Locality: Suzhou 
State or Province: Jiangsu 


Country Code (XX): | 86 


LE 


图 15.4 填写 keystore 文件 信息 


这 里 需要 注意 ,在 Validity 那 一 栏 填写 的 是 keystore 文件 的 有 效 时 长 ， 单 位 是 年 ， 一 般 建议 
时 间 可 以 填 得 长 一 些 ， 比 如 我 填 了 30 年。 然后 点 击 OK, 这 时 我 们 刚才 填写 的 信息 会 自动 填充 到 
创建 签名 APK 对 话 框 当中 ， 如 图 15.5 所 示 。 


如 果 你 希望 以 后 都 不 用 再 输 keystore 的 密码 了 , 可 以 将 Remember passwords 选项 勾 上 。 然 后 
点 击 Next， 这 时 就 要 选择 APK 文件 的 输出 地 址 了 ， 如 图 15.6 所 示 。 


y 
局 Generate Signed APK | 


r ry 
网 Generate Signed APK | 
Key store path: Ci\Users\Administrator\Documents\guolinjks Note: Proguard settings are ee using the Project Structure Dialog 
APK Destination Folder | \AndroidStudioprojects\CoolWeather || ~ | 
Create new... | | Choose existing... | > 
Build Type: | release | | 
Key store password: | ………… re 一 一 
Key alias: guolindev 
四 a 
Key password: ease 
DD Remember passwords 
[erevious | | Next | Ed Help Te min Cancel Help | 
| 


图 15.5 ”信息 自动 填充 完整 


图 15.6 选择 APK 文件 的 输出 地 址 


这 里 默认 是 将 APK 文件 生成 到 项 目的 根 目 录 下 ， 我 就 不 做 修改 了 。 现 在 点 击 Finish， 然 后 
稍 等 一 段 时 间 ，APK 文件 就 都 会 生成 好 了 ， 并 且 会 在 右上 角 弹 出 一 个 如 图 15.7 所 示 的 提示 。 


@ Generate Signed APK 
APK(s) generated successfully. 
Show in Explorer 


图 15.7 提示 APK 文件 生成 成 功 
我 们 点 击 提示 上 的 Show in Explorer 可 以 立刻 查看 生成 的 APK 文件 ， 如 图 15.8 所 示 。 


漂 
下 
RS 


步 一 一 将 应 用 发 布 到 360 应 用 商店 


app 
build 
gradle 

目 .gitignore 

| 多 app-release.apk 

图 build.gradle 

LL CoolWeather.iml 

| gradle.properties 


图 15.8 ”查看 生成 的 APK 文件 


这 里 的 app-release.apk 就 是 带 有 正式 签名 的 APK 文件 了 。 


15.1.2 使 用 Gradle 生 


上 一 小 节 中 我 们 使 用 了 Android Studio 提供 
除 此 之 外 ，Android Studio 其 实 还 提供 了 另外 一 种 方式 一 一 使 月 


= Rs 


成 


的 可 视 化 工具 来 生成 带 有 正式 签名 的 APK 文件 ， 
月 Gradle 生成 ， 下 面 我 们 前 


来 学 习 


Gradle 是 一 个 非常 先进 的 项 目 构 建 工 具 ， 在 Android Studio 中 开发 的 所 有 项 目 都 是 使 用 它 来 
构建 的 。 在 之 前 的 项 目 中 ， 我们 也 体验 过 了 Gradle 带 来 的 很 多 便利 之 处 ， 比 如 说 当 需 要 添加 依 


ra 
Cy 


赖 库 的 时 候 不 需要 自 
以 T Ls 


不 过 这 里 我 要 提醒 你 一 句 ， 如 果 你 想 将 Gradle 完全 精通 的 话 ， 这 个 难度 部 
想 要 完全 掌握 它 的 用 法 ， 其 复杂 程度 并 不 亚 于 学 习 一 门 新 的 
用 Groovy 语言 编写 的 )。 而 Android 中 主要 只 是 使 用 Gradle 来 构建 项 目 而 已 ， 


的 用 法 极为 丰富 ， 


去 手动 下 载 了 , 而 是 直接 在 dependencies 闭 包 中 添加 一 句 引 月 


比较 大 了 。 
语言 ( Gradle 是 使 
因此 这 里 我 们 掌握 


声明 就 可 


Gradle 


一 些 它 的 基本 用 法 就 好 了 ， 重 点 还 是 要 放 在 功能 开发 上 面 ， 不 要 本 末 倒 置 了 。 当 然 ， 如 果 你 对 
Gradle 非常 感 兴趣 ， 也 可 以 到 网 上 去 查询 它 的 更 多 用 法 。 

下 面 我 们 开始 学 习 如 何 使 用 Gradle 来 生成 带 有 正式 签名 的 APK 文件 。 编 辑 app/build.gradle 
文件 ， 在 android 闭 包 中 添加 如 下 内 容 : 


android { 
compileSdkVersion 
buildToolsVersion 
defaultConfig { 


24 


"24.0.2" 


applicationId "com.coolweather.android" 


minSdkVersion 


15 


targetSdkVersion 24 


versionCode 1 


versionName 
} 
signingConfigs { 
config { 


"1.09" 


storeFile file('C:/Users/Administrator/Documents/guolin.jks') 
storePassword '1234567 
keyAlias 'guolindev' 
keyPassword '1234567' 
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} 
buildTypes { 
release { 
minifyEnabled false 
proguardFiles getDefaultProguardFile('proguard-android.txt'), 
'proguard-rules.pro' 


} 


可 以 看 到 ， 这 里 在 android 闭 包 中 添加 了 一 个 signingConfigs 闭 包 ， 然 后 在 signingConfigs 闭 
包 中 又 添加 了 一 个 config 闭 包 。 接 着 在 config 闭 包 中 配置 keystore 文件 的 各 种 信息 ，storeFile 用 
于 指定 keystore 文件 的 位 置 ，storePassword 用 于 指定 密码 ，keyAlias 用 于 指定 别名 ，keyPassword 
用 于 指定 别名 密码 。 

将 签名 信息 都 配置 好 了 之 后 ， 接 下 来 只 需要 在 生成 正式 版 APK 的 时 候 去 应 用 这 个 配置 就 可 
以 了 。 继 续 编 辑 app/build.gradle 文件 ， 如 下 所 示 : 


android { 


buildTypes { 
release { 
minifyEnabled false 
proguardFiles getDefaultProguardFile('proguard-android.txt'), 
'proguard-rules.pro' 
signingConfig signingConfigs.config 


} 


这 里 我 们 在 buildTypes 下 面 的 release 闭 包 中 应 用 了 刚才 添加 的 签名 配置 ,这 样 当 生成 正式 版 
APK 文件 的 时 候 就 会 自动 使 用 我 们 刚才 配置 的 签名 信息 来 进行 签名 了 。 

现在 build.gradle 文件 已 经 配置 完成 ， 那 么 我 们 如 何 才能 生成 APK 文件 呢 ? 其 实 非 常 简单 ， 
Android Studio 中 内 置 了 很 多 的 Gradle Tasks， 其 中 就 包括 了 生成 APK 文件 的 Task。 点 击 右 侧 工 
具 栏 的 Gradle 一 项 目 名 一 :app 一 Tasks 一 build， 如 图 15.9 所 示 。 


Gradle projects 尝 - 路 国 
多 + 一 |@| 至 竺 品 | 只 | 车 8 
3 CoolWeather 器 
© CoolWeather (root) 
D :app 
[Ca Tasks 
[3 android 
[3 build 


全 assemble 

合 assembleAndroidTest 
合 assembleDebug 

登 assembleRelease 

合 build 

登 buildDependents 

登 buildNeeded 

全 clean 


图 15.9 查看 内 置 Gradle Tasks 
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其 中 assembleDebug 用 于 生成 测试 版 的 APK 文件 ，assembleRelease 用 于 生成 正式 版 的 APK 
文件 ，assemble 用 于 同时 生成 测试 版 和 正式 版 的 APK 文件 。 在 生成 APK 之 前 ， 先 要 双击 clean 
这 个 Task 来 清理 一 下 当前 项 目 ， 然 后 双击 assembleRelease ， 结 果 如 图 15.10 所 示 。 


Run 全 CoolWeatherapp [assembleRelease] 


BUILD SUCCESSFUL 


全 
+ 
写 
图 Total time: 38. 048 secs 
导 


14:13:17: External task execution finished "assembleRelease' . 


SR 裤 ToDo 党 GAndroidMonitor ”也 9:Version Control Terminal ” 邮 0: Messages 


图 15.10”assembleRelease 执行 成 功 


可 以 看 到 ， 这 里 提示 我 们 BUILD SUCCESSFUL, 说 明 assembleRelease 执行 成 功 了 。APK 
文件 会 自动 生成 在 app/build/outputs/apk 目录 下 ， 如 图 15.11 所 示 。 


EB Project | 日 未 | 类 -二 
[3 CoolWeather (C Administrator\Andro 
户 .gradle 
户 .idea 
四 app 
户 build 

DD generated 

户 intermediates 

户 outputs 

apk 


让 app-release.apk 


引 app-release-unaligned.apk 


图 15.11 查看 生成 的 APK 文件 


其 中 , app-release.apk 就 是 带 有 正式 签名 的 APK 文件 了 。 另外 还 有 一 个 app-release-unaligned. 
apk， 这 是 一 个 没有 经 过 对 齐 的 正式 版 APK 文件 ,我们 直接 忽略 它 就 可 以 了 。 

虽说 现在 APK 文件 已 经 成 功 生 成 了 ， 不 过 还 有 一 个 小 细节 需要 注意 一 下 。 目 前 keystore 文 
件 的 所 有 信息 都 是 以 明文 的 形式 直接 配置 在 build.gradle 中 的 ， 这 样 就 不 太 安全 。Android 推荐 的 
做 法 是 将 这 类 敏感 数据 配置 在 一 个 独立 的 文件 里 面 ， 然 后 再 在 build.gradle 中 去 读 取 这 些 数据 。 


下 面 我 们 来 按照 这 种 方式 实现 。 Android Studio 项 目的 根 目 录 下 有 一 个 gradle.properties 文件 ， 
它 是 专门 用 来 配置 全 局 键 值 对 数据 的 ， 我 们 在 gradle.properties 文件 中 添加 如 下 内 容 : 

KEY_PATH=C:/Users/Administrator/Documents/guolin.jks 

KEY_ PASS=1234567 


ALIAS NAME=guolindev 
ALIAS PASS=1234567 


可 以 看 到 , 这 里 将 keystore 文件 的 各 种 信息 以 键 值 对 的 形式 进行 了 配置 ,然后 我 们 在 build.gradle 
中 去 读 取 这 些 数据 就 可 以 了 。 编 辑 app/build.gradle 文件 ， 如 下 所 示 : 


android { 
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signingConfigs { 
config { 
storeFile file(KEY_PATH) 
storePassword KEY_PASS 
keyAlias ALIAS NAME 
keyPassword ALIAS_PASS 


} 


这 里 只 需要 将 原来 的 明文 配置 改 成 相应 的 键 值 ， 一 切 就 完工 了 。 这 样 直 接 查看 build.gradle 
文件 是 无 法 看 到 keystore 文件 的 各 种 信息 的 ,只 有 查看 gradle.properties 文件 才能 看 得 到 。 然后 我 
们 只 需要 将 gradle.properties 文件 保护 好 就 行 了 ， 比 如 说 将 它 从 Git 版 本 控制 中 排除 。 这 样 
gradle.properties 文件 就 只 会 保留 在 本 地 ， 从 而 也 就 不 用 担心 keystore 文件 的 信息 会 泄漏 了 。 


15.1.3 生成 多 渠道 APK 文件 


现在 你 已 经 掌握 了 两 种 生成 带 有 正式 签名 的 APK 文件 的 方式 ， 从 简易 程度 上 来 讲 ， 两 种 方 
式 差不多 ， 基 本 都 还 是 比较 简单 的 ， 选 择 使 用 哪 一 种 全 赁 你 自己 的 喜好 。 

现在 APK 文件 已 经 生成 好 了 , 可 能 在 大 多 数 情 况 下 , 我 们 都 只 需要 一 个 APK 文件 就 足够 了 ， 
不 过 本 小 节 中 我 们 再 来 讨论 一 种 比较 特殊 的 情况 一 一 生成 多 渠道 APK 文件 。 

在 本 章 的 开头 就 已 经 提 到 过 ， 目 前 Android 领域 的 应 用 商店 非常 多 ， 不 像 苹果 只 有 一 个 App 
Store。 当 然 我 们 完全 可 以 使 用 同一 个 APK 文件 来 上 架 不 同 的 应 用 商店 ， 但 是 如 果 你 有 一 些 特殊 
需求 的 话 ， 比 如 说 针对 不 同 的 应 用 商店 渠道 来 定制 不 同 的 界面 ， 这 就 比较 头疼 了 。 

传统 情况 下 ,开发 这 种 差异 性 需求 非常 痛苦 ， 通 常 需要 维护 多 份 代码 版 本 ， 然 后 逐个 打 成 相 
应 渠道 的 APK 文件 。 一 旦 有 任何 功能 变更 就 苦 不 堪 言 ， 因 为 每 份 代码 版 本 里 面 都 需要 逐个 修改 
一 忆 。 

吉 运 的 是 ， 现 在 Android Studio 提供 了 一 种 非常 方便 的 方法 来 应 对 这 种 差异 性 需求 ， 极 大 程 
度 地 解决 了 之 前 版 本 维护 困难 的 问题 ， 下 面 我 们 就 来 学 习 一 下 。 


比如 说 这 里 我 们 准备 生成 360 和 百度 两 个 渠道 的 APK 文件 , 那么 修改 app/build.gradle 文件 ， 
如 下 所 示 : 


android { 

compileSdkVersion 24 

buildToolsVersion "24.0.2" 

defaultConfig { 
applicationId "com.coolweather.android" 
minSdkVersion 15 
targetSdkVersion 24 
versionCode 1 
versionName "1.0" 
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productFlavors { 
qihoo { 
appLicationId "com.coolweather.android.qihoo" 
} 
baidu { 
appLicationId "com.coolweather.android.baidu" 


} 


可 以 看 到 , 这 里 添加 了 一 个 productFLavors 闭 包 , 然后 在 该 闭 包 中 添加 所 有 的 渠道 配置 就 
可 以 了 。 注意 Gradle 中 的 配置 规定 不 能 以 数字 开头 , 因此 这 里 我 将 360 的 渠道 名 配置 成 了 qihoo。 
渠道 名 的 闭 包 中 可 以 履 写 defaultConfig 中 的 任何 一 个 属性 ， 比 如 说 这 里 将 applicationId 属性 
进行 了 覆 写 ， 那 么 最 终生 成 的 各 渠道 APK 文件 的 包 名 也 将 各 不 相同 。 

接 下 来 我 们 开始 针对 不 同 渠道 编写 差异 性 需求 。 在 app/src 目录 下 main 的 平 级 目录 ) 新 建 
一 个 baidu 目录 ， 然 后 在 baidu 目录 下 再 新 建 java 和 res 这 两 个 目录 ， 如 图 15.12 所 示 。 


功名 Project 到。 未 | 来 - 及 
Ee [3 CoolWeather trat 
洒 DD .gradle 
” Didea 
加 app 
疡 build 
Dlibs 
户 src 
四 androidTest 
Dbaidu 
呈 Djava 
Cares 
Dmain 
Dtest 


图 15.12 创建 渠道 专属 目录 

这 样 我 们 就 可 以 在 这 里 编写 百度 渠道 特有 的 功能 了 ，java 目录 用 于 存放 代码 ，res 目录 用 于 
存放 资源 ， 如 果 需 要 覆 写 AndroidManifest 文件 中 的 内 容 ， 还 可 以 在 baidu 目录 下 再 新 建 一 个 
AndroidManifest.xml 文件 。 

当然 , 实际 上 我 们 并 没有 什么 渠道 差异 性 的 需求 ， 因 此 这 里 也 只 是 为 了 演示 一 下 ,我 们 就 给 
不 同 渠 道 的 APK 起 一 个 不 同 的 应 用 名 吧 。 

应 用 名 之 前 是 定义 在 main/res/values/string.xml 文件 中 的 ， 那么 我 们 在 baidu 目录 下 也 建立 一 
个 相同 的 目录 结构 ， 然 后 将 baidu/res/values/string.xml 中 的 内 容 进 行 如 下 修改 : 


<resources> 
<string name="app_name"> 酷 欧 百 度 版 </string> 
</resources> 


这 样 百 度 渠 道 的 APK 就 会 使 用 baidu/res/values/string.xml 中 定义 的 应 用 名 来 覆盖 原 有 的 应 用 
名 。 同 样 的 道理 ， 我 们 再 新 建 一 个 qihoo 目录 ， 然 后 在 qihoo 目录 下 也 建立 相同 的 目录 结构 ， 并 
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将 string.xml 中 的 内 容 进行 如 下 修改 : 


<resources> 
<string name="app_name"> 酷 欧 360 版 </string> 
</resources> 


这 样 我 们 就 以 一 个 简单 的 示例 实现 渠道 差异 性 需求 了 ， 下 面 开 始 来 生成 多 渠道 的 APK 文件 。 观 
察 右 侧 工具 栏 的 Gradle Tasks 列表 ， 你 会 发 现 里 面 多 出 了 几 个 新 的 Task， 如 图 15.13 所 示 。 


Gradle projects | 
人 5 十 一 |@ | 至 主 避 | 中 | 区 
V (5 CoolWeather 
bp (5 CoolWeather (root) 
v 他 :app 
了 CaTasks 
p [Caandroid 
v Ca build 
党 assemble 
党 assembleAndroidTest 
全 assembleBaidu 
全 assembleDebug 
六 assembleQihoo 
过 assembleRelease 
党 build 
党 buildDependents 
绩 buildNeeded 
党 clean 


图 15.13 查看 新 的 Task 
其 中 ， 如 果 你 只 想 生 成 百度 渠道 的 APK 文件 ， 那 么 就 执行 assembleBaidu; 如 果 你 只 想 生 成 
360 渠道 的 APK 文件 ， 那 么 就 执行 assembleQihoo; 如 果 你 想 一 次 性 生成 所 有 渠道 的 APK 文件 ， 
那么 就 还 是 执行 assembleRelease。 
除了 使 用 Gradle 的 方式 生成 之 外 , 使 用 Android Studio 提供 的 可 视 化 工具 也 是 能 生成 多 渠道 
APK 文件 的 ， 如 图 15.14 所 示 。 
{ ® Generate signed APK [ex 


Note: Proguard settings are specified using the Project Structure Dialog 


alpelD 了 


APK Destination Folder: | \AndroidStudioProjects\CoolWeather | | 


Build Type: | release | "| 
Elovors, [SS 
qihoo 


[EC (ree | 


|. J 


图 15.14 ”使 用 可 视 化 工具 生成 多 渠道 APK 
这 里 我 们 可 以 选择 是 生成 百度 渠道 的 APK 文件 ,还 是 生成 360 渠道 的 APK 文件 ， 如 果 你 想 
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一 次 性 生成 多 个 渠道 的 APK 文件 ， 按 住 CTRL 键 就 可 以 进行 多 选 了 。 
接 下 来 我 们 可 以 通过 adb install 命令 将 生成 好 的 APK 文件 安装 到 模拟 器 上 ， 如 图 15.15 
所 示 。 


rator \AndroidStudioProjects\ 


图 15.15 将 生成 的 APK 安装 到 模拟 器 上 
adb install 命令 的 后 面 加 上 APK 文件 的 路 径 ， 就 可 以 将 该 APK 文件 安装 到 模拟 器 上 了 。 
我 们 使 用 同样 的 方法 将 百度 和 360 这 两 个 渠道 的 APK 文件 都 安装 到 模拟 器 上 ， 结 果 如 图 15.16 
所 示 。 


图 15.16 模拟 器 上 的 安装 结果 


可 以 看 到 ， 目 前 模拟 器 上 有 3 个 版 本 的 酷 欧 天 气 ， 这 是 由 于 之 前 我 们 在 productFlavors 中 覆 
写 了 各 渠道 的 appLicationId 属性 , 保证 每 个 APK 文件 的 包 名 都 不 相同 , 因而 它们 才能 安装 到 
同一 个 设备 上 面 。 另 外 ， 从 应 用 名 上 来 看 ， 渠 道 差异 性 开发 工作 也 顺利 完成 了 。 

不 过 ， 上 面 的 例子 只 是 为 了 演示 生成 多 渠道 APK 功能 而 特意 编写 的 ， 实 际 上 我 们 并 没有 
这 个 需求 。 现 在 将 productFLavors 闭 包 删除 ， 恢 复 成 之 前 的 APK 文件 ， 我 们 准备 进行 上 架 
操作 。 


15.2 ”申请 360 开发 者 账号 


目前 ， 酷 欧 天 气 的 APK 安装 包 已 经 准备 好 了 ， 但 如 果 想 要 把 它 发 布 到 360 应 用 商店 ， 还 需 
要 去 申请 一 个 360 开发 者 账号 才 行 ， 申 请 地 址 是 : http:/dev.360.cn。 

打开 该 网 页 , 在 页 面 顶部 有 登录 和 注册 按钮 。 如 果 你 还 没有 360 账号 ， 则 需要 在 这 里 注册 一 
个 新 的 账号 ， 如 果 你 之 前 已 经 有 360 账号 了 ， 那 么 直接 登录 就 可 以 了 。 

登录 成 功 之 后 打开 http://dev.360.cn/mod/developer 这 个 网 址 , 来 申请 成 为 开发 者 ， 如 图 15.17 
所 示 。 
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请 选择 注册 开发 者 类 型 
@ 个 人 开发 者 【 爹 】 企业 开发 者 
用 个 人 开发 青 ， 揭 芝 发 布 应 用 和 免 妆 游戏 到 360 手 机 助手 壬 用 公司 企业 、 克 注册 ,可 以 接 和 支付 SDKi# 字 有 360 稚 
开发 家 业 开 发 许 在 平台 权 有 何 区 到 


图 15.17 选择 注册 开发 者 类 型 
这 里 可 以 选择 是 申请 成 为 个 人 开发 者 还 是 企业 开发 者 。 很 显然 , 我 们 是 以 个 人 的 身份 来 发 布 
应 用 的 ， 那 么 点 击 个 人 开发 者 就 可 以 了 。 
接 下 来 需要 填写 一 些 基 本 信息 和 联系 方式 ， 如 图 15.18 所 示 。 


| 基本 信息 


注册 账号 : ”sinyu890807@126.com 


用 此 账号 进行 登录 


开发 者 姓名 : 


出 品 人 : 
传 手持 身份 证 照片 ,jpg、png、9gif 咎 式 的 图 片 ( 不 超过 


个 人 身份 证 件 : 护照 


国内 开发 者 请 填写 15 位 或 18 位 大 陆 身份 证 号 码 ， 国 外 开发 者 请 填写 护照 号 码 


图 15.18 ” 填 基 本 信息 和 联系 方式 


填写 完 基本 信息 之 后 向 下 深 动 继续 填写 联系 方式 ,全 部 填写 完成 之 后 , 点击 屏幕 最 下 方 的 “ 同 
意 并 注册 开发 者 ”按钮 来 完成 注册 ， 如 图 15.19 所 示 。 


回 我 已 阅读 并 同意 《360 移 动 开放 平台 服务 条 款 》 


同意 并 注册 开发 者 


图 15.19 ”完成 开发 者 注册 
这 样 你 就 成 功 成 为 一 名 360 开发 者 了 ! 
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15.3 发布 应 用 程序 


接 下 来 我 们 开始 发 布 酷 欧 天 气 这 个 应 用 ， 还 是 在 浏览 器 访问 地 址 : http://dev.360.cn， 你 会 在 
界面 上 看 到 如 图 15.20 所 示 的 内 容 。 
然后 点 击 软 件 发 布 ， 就 会 显示 如 图 15.21 所 示 的 界面 。 


请 选择 软件 类 型 
发 布 软件 类 应 用 ， 如 : 新 闻 类 应 用 ， 购 物 类 应 用 发 布 电子 书 应 用 ， 如 : 单 本 小 说 、 杂 志 、 漫 画 等 
图 15.20 ”软件 发 布 和 游戏 发 布 图 15.21 选择 软件 类 型 


我 们 需要 选择 是 发 布 软件 类 应 用 还 是 电子 书 类 应 用 , 这 里 点 击 软件 。 接 下 来 会 弹出 一 个 新 的 
界面 让 我 们 上 传 APK 以 及 填写 应 用 信息 。 首 先 来 上 传 APK 吧 , 点 击 上 传 按钮 ， 选 择 带 有 正式 签 
名 的 APK 文件 ， 然 后 就 会 自动 开始 上 传 了 ， 上 传 完成 之 后 会 显示 如 图 15.22 所 示 的 界面 。 


安全 系数 您 的 应 用 安全 系数 未 达标 ! 加 国 
可 减少 盗版 和 破解 ， 保 障 用 户 安 
0 全 使 用 。 
a 
用 


图 15.22 上传 APK 完成 

这 个 界面 提醒 我 们 ， 目 前 应 用 的 安全 系数 较 低 ， 建 议 对 APK 进行 加 固 。 实 际 上 这 个 是 360 
应 用 商店 的 特殊 需求 , 并 不 是 所 有 应 用 商店 都 要 求 进行 加 固 的 。 但 是 我 们 还 是 得 按照 它 的 要 求 来 
修改 ， 不 然 审核 可 能 会 不 通过 。 

这 里 点 击 立 即 加 固 按钮 ，360 会 帮忙 我 们 将 原 APK 文件 进行 加 固 ， 并 生成 一 个 新 的 APK 文 
件 ， 如 图 15.23 所 示 。 


加 园 成 功 ， 请 下 载 后 重新 签名 ， 再 次 提交 审核 。 
温 声 提示 : 
1. 您 以 后 的 更 新 包 可 以 到 360 加 国保 加 国 并 签名 ， 再 上 传 平台 审核 


2. 使 用 360 加 固 助手 ， 一 键 完成 应 用 加 固 . 签 名 . 打 渠 道 包 .发 布 市 场 等 操作 。 立即 
下 载 


图 1$.23 加固 成 功 提示 


不 过 这 个 加 固 后 的 APK 文件 是 没有 经 过 签名 的 ， 也 就 是 说 我 们 还 需要 将 它 下 载 下 来 ， 然 后 
手动 进行 签名 才 行 。 
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点 击 下 载 应 用 按钮 ， 先 将 加 固 后 的 APK 文件 下 载 下 来 。 接 下 来 的 工作 就 有 点 烦琐 了 ， 因 为 
Android Studio 中 并 没有 提供 对 一 个 未 签名 的 APK 直接 进行 签名 的 功能 ， 因 此 我 们 只 能 通过 最 原 
始 的 方式 ， 使 用 jarsigner 命令 来 进行 签名 。 

在 命令 行 界面 按照 以 下 格式 输入 签名 命令 : 


jarsigner -verbose -sigalg SHAlwithRSA -digestalg SHA1 -keystore [keystore 文件 路 径 ] 
-Storepass [keystore 文件 密码 ] [ 待 签名 APK 路 径 ] [keystore 文件 别名 ] 


将 [] 中 的 描述 蔡 换 成 keystore 文件 的 具体 信息 就 能 签名 成 功 了 , 注意 [] 符 号 是 不 需要 的 。 接 
着 我 们 将 签名 后 的 APK 文件 重新 上 传 就 可 以 了 。 
APK 上 传 成 功 之 后 ， 接 下 来 需要 选择 应 用 的 分 类 ， 如 图 15.24 所 示 。 


上 传 版 权证 明 ( 选 填 ): 


PNG 或 压缩 包 格 式 ， 图 片 大 小 不 能 超过 1WB ， 有 亲 个 文件 请 打包 为 RAR 、ZIF 格 式 ， 大 小 不 能 超过 10ME 


版 权证 明 是 什么 ? 软 著 快速 申请 


图 15.24 ”选择 应 用 分 类 


这 里 我 们 将 应 用 分 类 选择 成 实用 工具 一 天 气 。 下面 还 有 一 个 上 传 版 权证 明 的 选项 , 这 是 一 个 
选 填 项 ,我 们 直接 忽略 就 可 以 了 。 


接着 向 下 深 动 网 页 ， 设置 支持 的 语言 以 及 资费 类 型 ， 如 图 15.25 所 示 。 


支持 语言 : 简体 中 文 ， © 


图 15.25 设置 支持 语言 和 资费 类 型 


继续 滚动 网 页 ， 下 面 需要 填写 应 用 简介 以 及 当前 版 本 介绍 ， 如 图 15.26 所 示 。 


步 一 一 将 应 用 发 布 到 360 应 用 商店 


员 
泪 
地 
涉 
下 
RS 


应 用 简介 : ” 酷 欧 天 气 是 一 款 基 于 Android 端 开源 的 天 气 预报 软 件 ， 具 备查 看 ©@ 
全 国 的 省 市 县 、 查 询 任意 城市 天 气 、 自 由 切换 城市 、 手 动 更 新 天 
气 、 后 台 自 动 更 新 天 气 等 功能 。 酷 欧 天 气 中 的 天 气 数据 由 和 风 天 
气 提供 ， 背 景 图片 由 必 应 提供 ， 代 码 遵循 Apache v2 License 开 源 
协议 。 本 软件 主要 作为 学 习 和 交流 使 用 。 


50-1500 字 ， 请 向 用 户 介绍 一 下 你 的 应 用 。 


当前 版 本 介绍 : ” 酷 欧 天 气 是 一 款 基 于 Android 庙 开源 的 天 气 预报 软件 ， 县 备 坦 看 ©@ 
全 国 的 省 市 县 、 查 询 任意 城市 天 气 、 自 由 切换 城市 、 手 动 更 新 天 
气 、 后 台 自 动 更 新 天 气 等 功能 。 


50-400 字 符 ， 请 向 用 户 介绍 当前 应 用 版 本 及 更 新 内 容 。 
图 15.26 ”填写 应 用 简介 和 当前 版 本 介绍 
在 版 本 介绍 的 下 面 ，360 还 要 求 填 写 一 项 隐私 权限 说 明 ， 由 于 酷 欧 天 气 只 申请 了 一 个 网 络 权 
限 ， 因 此 没什么 需要 说 明 的 ， 我们 直接 忽略 这 一 项 就 可 以 了 。 


继续 向 下 深 动 网 页 ， 接 下 来 需要 上 传 一 张 高 分 状 率 的 应 用 图 标 ， 图 标 要 求 是 512 x 512 像素 
的 PNG 格式 图 片 ， 如 图 15.27 所 示 。 


应 用 图 标 : ”要 求 与 安装 包 中 图 标 一 到。 A 512*512PX， 圆 钊 半径 弧度 : 70PX， 图 片 格式 : PHG。 请 按照 右 提 示例 上 传 。 


图 15.27 ”上传 高 分 辩 率 的 应 用 图 标 


上 传 好 了 图 标 , 我 们 还 需要 提供 5 张 酷 欧 天 气 的 屏幕 截图 ， 点 击 上 传 截图 按钮 ， 然 后 选择 准 
备 好 的 图 片 即 可 ， 如 图 15.28 所 示 。 
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应 用 截图 : 请 上 传 4-5 张 截图 (尺寸 保持 一 致 》， 支 持 JPG、Plic 格 式 。 截 图 尺寸 要 求 : 不 小 于 8004480 (4804800) ， 单 张 图 片 不 能 超过 3W。 请 去 除 截 图 中 的 项 部 
知 栏 。 查看 示例 
© 
D4 D4 
D4 


图 15.28 ”上传 屏幕 截图 


继续 向 下 滚动 , 还 有 一 个 审核 辅助 说 明 的 选 填 项 ,我 们 也 直接 忽略 就 可 以 了 。 最 后 就 是 一 些 
额外 的 定制 选项 ， 如 图 15.29 所 示 。 


是 否 进行 云 测试 : 是 四 否 


由 Testin 云 测 提供 专业 的 应 用 机 型 出 起 ， 选 择 后 将 自动 为 您 的 应 用 进行 云 测 坛 ， 并 发 送 负 坛 报告 


发 布 时 间 : ”并 审核 后 立即 发 布 日 定时 发 布 


图 15.29 ”额外 的 辅助 选项 

这 里 我 们 选择 不 进行 云 测 试 ， 并 在 审核 后 立即 发 布 。 

激动 人 心 的 时 刻 终 于 到 了 , 现在 点 击 一 下 提交 审核 按钮 就 可 以 将 酷 欧 天 气 发 布 到 360 应 用 商 
店 了 ， 这 时 会 显示 如 图 15.30 所 示 的 提示 。 


提交 成 功 ! 
我 们 将 在 一 个 工作 日 内 完成 审核 ， 通 过 邮件 和 短信 告知 结果 ， 请 注意 查收 。 


> 


图 15.30 ”提交 成 功 提示 


由 于 360 会 对 我 们 的 应 用 程序 进行 审核 , 接 下 来 又 进入 了 等 待 当 中 。 不 过 还 好 , 根据 提示 来 
看 ， 这 次 也 许 不 需要 等 太 久 。 
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果不其然 , 过 了 几 个 小 时 之 后 在 360 手机 助手 上 搜索 酷 欧 天 气 关 键 字 ， 就 可 以 看 到 这 个 应 用 
已 经 成 功 上 线 了 ， 如 图 15.31 所 示 。 


点 击 进去 可 以 查看 应 用 的 详情 ， 如 图 15.32 所 示 。 


灵犀 语音 助手 
[站 。 [ Fw | 
0 


时 这 天 气 @ 5 
Tm 
这 hake EE | 酪 欧 天 气 是 一 款 基于 Android 端 开源 的 天 气 
\®) 预报 软件 ， 具 备查 看 全 国 的 省 市 县 、 查 询 任意 城市 天 
Re 用 户 评价 


so Ey a 
| [| 
图 15.31 ”搜索 酷 欧 天 气 关键 字 图 15.32 ”查看 应 用 详情 
到 了 这 里 , 我 们 就 将 应 用 程序 的 发 布 工 作 全 部 完成 了 , 之 后 你 应 该 尽 可 能 地 多 为 你 的 应 用 进 
行 宣传 ， 因 为 用 户 越 多 , 你 能 得 到 的 回报 就 越 大。 那么 如 何 才能 从 我 们 辛 辛 若 若 编写 的 程序 中 得 
到 回报 呢 ? 方式 有 很 多 种 ,其 中 较为 常见 的 做 法 就 是 通过 广告 来 进行 僵 利 , 因此 下 一 节 我 们 就 学 


习 一 下 ， 如 何在 应 用 程序 中 舰 入 广告 。 
15.4 贬 入 广告 进行 服 利 


谷歌 充分 考虑 到 了 可 以 在 Android 应 用 程序 中 舰 入 广告 来 让 开发 者 获得 收入 ， 因 此 早早 地 就 
收购 了 AdMob 公司 。AdMob 创立 于 2006 年 ， 是 全 球 最 早 致力 于 在 移动 设备 上 提供 广告 服务 的 
公司 之 一 ， 如 今 成 为 了 谷歌 的 子 公司 ，AdMob 的 广告 更 加 适合 在 Android 系统 以 及 Google Play 
上 面 进行 投放 。 

不 过 对 于 国内 开发 者 来 说 ，AdMob 可 能 就 不 是 那么 适合 了 。 因 为 AdMob 平台 上 的 广告 大 多 
都 是 英文 的 ， 中 文 广告 数 有 限 ， 并 且 将 AdMob 账户 中 的 钱 提取 到 银行 账户 中 也 比较 麻烦 ， 因 此 
这 里 我 们 就 不 准备 使 用 AdMob 了 ， 而 是 将 眼光 放 在 一 些 国内 的 移动 广告 平台 上 面 。 在 国内 的 这 
一 领域 , 做 得 比较 好 的 移动 广告 平台 也 不 少 ， 其 中 我 个 人 认为 腾讯 广告 联盟 ( 原 广 点 通 ) 特别 专 
业 ， 因 此 我 们 就 选择 它 来 为 酷 欧 天 气 提供 广告 服务 吧 。 


15.4.1 注册 腾讯 广告 联盟 账号 
下 面 开 始 动手 , 首先 第 一 步 我 们 需要 注册 一 个 腾讯 广告 联盟 的 账号 , 注册 地 址 为 : http://e.qq. 
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com/dev/index.html。 

打开 该 网 页 ,选择 使 用 QQ 号 登录 ,然后 就 会 自动 跳 转 到 腾讯 广告 联盟 的 注册 界面 ,如 图 15.33 
所 示 。 图 15.33 中 的 所 有 内 容 都 是 必 填 项 ， 我 们 按照 实际 情况 来 填写 就 可 以 了 ， 填 写 完成 之 后 点 
击 下 一 步 ， 如 图 15.34 所 示 。 


会 员 类 型 : 个 人 请 选择 正确 的 会 员 类 型 ， 否 则 无 法 获取 收益 
姓名 : 收 款 方 ， | 名 要 
身份 证 号 码 : 开户 银行 : ”请 选择 M 
联系 必 灶 * | 北市 东城 s 开户 行 所 在 地 :| 北京 市 | | 东城 v 
支行 名 称 : 
手机 号 码 : 
一 一 一 一 一 一 一 银行 账号 : 
电子 邮箱 : 
账号 确认 : 
电子 邮箱 验证 码 : 获取 邮箱 验证 码 
| ee 支持 格式 仅 限 jpg,png, 大 小 2M 以 内 
银行 卡 正面 照片 : 
注册 来 源 : ~ | 选择 文件 | 未 选择 任何 文件 


图 15.33 ”填写 个 人 信 ) 图 15.34 ”填写 银行 卡 信息 


由 于 腾讯 广告 联盟 涉及 提现 服务 ， 因 此 我 们 还 需要 填写 银行 卡 信 息 ， 并 上 传 银 行 卡 照 片 。 填 
写 完成 之 后 继续 点 击 下 一 步 ， 如 图 15.35 所 示 。 


最 后 ， 将 你 的 身份 证 正 反 面 照 片上 传 ， 点 击 提交 按钮 ， 就 能 提交 审核 了 ， 如 图 15.36 所 示 。 


身份 证 正面 照片 : | 选择 文件 | 未 选择 任何 文件 


斌 


会 员 注 册 x 
身份 证 反面 照片 : | 选择 文件 | 未 选择 任何 文件 
您 的 会 员 注册 已 提交 成 功 ,我 们 会 在 1 个 工作 日 内 完成 审核 ,请 耐心 等 待 。 


支持 格式 促 限 jpg,png, 大 小 2M 以 内 
YY 同意 《腾讯 广 点 通 移动 联盟 开发 者 协议 》 


图 15.35 上 传 身份 证 照片 图 15.36 ”提交 审核 


只 要 你 前 面 填写 的 内 容 都 是 真实 有 效 的 , 审核 一 般 都 会 很 快 通过 , 这 里 我 们 只 需要 耐心 等 待 
几 个 小 时 就 好 了 。 
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最 后 一 步 一 一 将 应 用 发 布 到 360 应 用 商店 


15.4.2 ”新 建 媒体 和 广告 位 


审核 通过 之 后 , 我 们 就 可 以 进入 到 腾讯 广告 联盟 的 后 台 ， 开始 给 酪 欧 天 气 添 加 广告 了 。 首 先 
需要 进入 媒体 管理 界面 ， 点 击 新 建 媒体 按钮 ， 这 时 会 显示 一 个 页 面 来 让 你 填写 应 用 的 相关 信息 ， 
我 们 根据 提示 一 一 填 好 即 可 ， 如 图 15.37 所 示 。 


系统 平台 : 


媒体 名 称 : 


关键 词 : 


媒体 类 别 : 


媒体 简介 : 


详情 页 地 址 : 


@ ! 叫 ! androd 记 | osgF 
酮 欧 天气 

天 

生活 实用 v | 天 要 


酷 欧 天 气 是 一 款 基于 mdroid 端 开源 的 天 气 预报 软 
具备 查 用 查询 任意 城市 天 气 、 


件 , 具备 查 、 查 
自由 切换 城市 、 手 动 更 新 天 气 、 后 台 自 动 更 新 天 气 


等 功能 


com.coolweather.android 


全 已 上 架 未 上 架 


http://zhushou.360.cn/detail/index/sof | 


下 一 步 


图 15.37 填写 应 用 的 相关 信息 

注意 这 里 需要 填写 一 个 详情 页 地 址 ,也 就 是 酷 欧 天 气 在 360 应 用 商店 上 的 详情 页 地 址 。 打 开 
http://zhushou.360.cn， 在 搜索 框 上 输入 “ 酷 欧 天 气 ”， 就 能 找到 该 地 址 了 。 
填写 完成 之 后 点 击 下 一 步 ， 接 下 来 需要 下 载 SDK， 如 图 15.38 所 示 。 

点 击 Android SDK 下 载 按钮 ， 先 把 SDK 下 载 下 来 ， 我 们 稍 后 就 会 进行 接 人 人。 继续 点 击 下 一 


步 ， 如 图 15.39 所 示 。 


媒体 名 称 : 酷 欧 天 气 


媒体 类 型 ; 甘 ! Andriod 程 序 


应 用 ID : 1105585573 


上 一 步 下 一 步 


图 15.38 ”下载 SDK 


这 里 要 求 填 人 一 个 APK 的 下 载 的 地 址 ， 


媒体 名 称 : 
媒体 类 型 : 


应 用 ID : 


应 用 程序 : 


HB 
图 15.39 ”完成 媒体 创建 
我 们 直接 就 填 入 图 15.37 当中 的 详情 页 地 址 就 可 以 


酷 欧 天 气 
位! Andriod 程 序 


1105585573 


上 传 外 输入 下 载 URL 


http://zhushou.360.cn/detail 
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了 。 点 击 完 成 按钮 ， 现 在 又 会 进入 到 审核 等 待 当 中 。 

为 什么 新 建 媒 体 也 需要 进行 审核 呢 ? 这 是 因为 腾讯 为 了 防止 某 些 开发 者 在 垃圾 软件 上 面 投 
放 广 告 ， 因 此 要 求 开发 者 必须 提交 应 用 程序 的 APK 文件 进行 审核 ， 只 有 审核 通过 的 应 用 才 人 允许 
进行 广告 投放 。 那 么 我 们 只 能 继续 等 待 。 审 核 通过 之 后 ， 在 媒体 管理 界面 查看 新 建 媒体 的 状态 ， 
如 图 15.40 所 示 。 


应 用 ID 媒体 名 称 联盟 开通 状态 业务 状态 系统 平台 探 作 


1105585573 酷 欧 天 气 已 开通 正常 Android 修改 新 建 广告 位 


图 15.40 查看 新 建 媒 体 的 状态 
可 以 看 到 , 联盟 开通 状态 显示 已 开通 , 业务 状态 显示 正常 , 说 明 新 建 的 媒体 已 经 通过 审核 了 。 
注意 这 里 还 自动 生成 了 一 个 应 用 ID ， 我 们 稍 后 就 会 用 到 。 
现在 点 击 新 建 广告 位 ， 就 可 以 来 创建 一 个 广告 位 了 ， 如 图 15.41 所 示 。 


媒体 选择 : 酮 欧 天 气 


广告 位 名 称 : 启动 广告 


广告 位 类 型 : Banne 广 告 应 用 墙 插 屏 广告 “多 开 屏 广告 
YY 成 人 用 品类 
W 医疗 科室 类 
茂 肥 类 
屏蔽 行业 : 心理 健康 类 
星座 算命 类 
W，P2p 网 贷 平 台 
如 果 对 于 某 些 类 型 的 广告 素材 (例如 成 人 用 品 ) 过 于 敏感 ， 您 可 以 进行 行业 广告 屏蔽 
图 15.41 新 建 广告 位 
首先 要 输入 广告 位 的 名 称 , 然后 选择 广告 位 的 类 型 。 腾 讯 广 告 联盟 支持 Banner、 应 用 增 、 插 


屏 和 开 屏 这 4 种 广告 类 型 ， 具体 每 种 广告 类 型 的 区 别 你 可 以 通过 查阅 文档 进行 了 解 ,， 这 里 我 们 选 
择 开 屏 广告 。 接 下 来 还 可 以 对 一 些 敏 感 行 业 的 广告 进行 屏蔽 , 选择 完成 之 后 点 击 创建 按钮 完成 广 
告 位 创建 。 

现在 进入 到 广告 位 管理 界面 ， 就 能 查看 到 我 们 刚刚 新 建 的 广告 位 了 ， 如 图 15.42 所 示 。 


名 称 &ID 广告 位 类 型 所 属 应 用 &ID 业务 状态 广告 位 状态 探 作 


启动 广告 酷 欧 天 气 
开 屏 正常 启用 中 修改 
4010212448179536 1105585573 


图 15.42 ”查看 新 建 广告 位 


其 中 ，4010212448179536 是 广告 位 ID，1105585573 是 应 用 ID。 有 了 这 两 个 数据 之 后 ,我 们 
就 可 以 开始 接 入 广告 SDK 了 。 
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15.4.3 接 入 广告 SDK 


首先 将 刚才 下 载 的 广告 SDK 压缩 包 解 压 ， 里 面 的 内 容 非常 简单 ， 如 图 15.43 所 示 。 


resources 
@ GDT DEV guide.4.9.html 

症 GDTUnionDemo.zip 

四 | GDTUnionSDK.4.9.533.minjar 


15.43 ”广告 SDK 压缩 包 中 的 内 容 
其 中 resources 文件 夹 中 放 的 是 一 些 资源 图 片 ， 我 们 使 用 不 到 。GDT DEYV guide.4.9.html 是 广 


告 SDK 的 对 接 文档 ,GDTUnionDemo.zip 是 广告 SDK 的 对 接 示 例 , GDTUnionSDK.4.9.533.min.jar 
则 是 广告 SDK 中 最 主要 的 一 个 Jar 包 文件 了 。 


由 于 腾讯 广告 SDK 中 的 功能 还 是 挺 多 的 ， 这 里 不 可 能 面面俱到 ， 将 每 一 个 功能 都 进行 详细 


地 讲解 。 因 此 我 准备 只 讲解 开 屏 广告 这 一 种 类 型 的 广告 用 法 , 剩 下 的 其 他 功能 你 可 以 通过 阅读 文 
档 来 进行 学 习 。 


顶部 工具 栏 中 的 Sync 按钮 完成 同步 。 


我 们 先 将 GDTUnionSDK.4.9.533.min.jar 复制 到 app/libs 目录 当中 ,并 点 击 一 下 Android Studio 


接着 在 AndroidManifest.xml 中 声明 以 下 权限 , 其 中 网 络 访问 权限 是 之 前 声明 过 的 , 不 需要 声 


明 两 遍 。 


可 


ULD 


<uses-permission android:name="android.permission.INTERNET” /> 
<uses-permission android:name="android.permission.ACCESS NETWORK STATE" /> 
<uses-permission android:name="android.permission.ACCESS WIFI STATE" /> 
<uses-permission android:name="android.permission.READ PHONE STATE" /> 
<uses-permission android:name="android.permission.ACCESS COARSE LOCATION" /> 
<uses-permission android:name="android.permission.ACCESS COARSE UPDATES" /> 
<uses-permission android:name="android.permission.WRITE EXTERNAL STORAGE" /> 


注意 , 其 中 READ _PHONE STATE、ACCESS COARSE LOCATION 和 WRITE EXTERNAL STORAGE 
个 权限 是 危险 权限 ， 因 此 我 们 待 会 还 需要 进行 运行 时 权限 处 理 。 
接 下 来 在 <application> 标 签 中 添加 如 下 内 容 : 


<activity 
android:name="com.qq.e.ads.ADActivity" 
android:configChanges="keyboard|keyboardHidden|orientation|screenSize" /> 
<service 
android:name="com.qq.e.comm.DownloadService" 
android:exported="false" /> 


这 样 就 将 配置 工作 完成 了 。 
然后 我 们 还 需要 创建 一 个 用 于 显示 开 屏 广告 的 活动 ， 右 击 com.coolweather.android 包 一 New 


一 Activity 一 Empty Activity， 创 建 一 个 SplashActivity， 并 将 布局 名 指定 成 activity_splash.xml。 修 
改 activity_splash.xml 中 的 代码 ， 如 下 所 示 : 
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<RelativeLayout 
xmlns:android="http://schemas.android.com/apk/res/android" 
android:id="@+id/container" 
android:layout width="match parent" 
android:layout height="match parent"> 


</RelativeLayout> 

这 里 只 有 一 个 空 的 RelativeLayout, 我 们 并 不 需要 在 RelativeLayout 当中 放 入 什么 内 容 , 但 是 
必须 给 它 定义 一 个 id。 

接着 修改 SplashActivity 中 的 代码 ， 如 下 所 示 : 


public class SplashActivity extends AppCompatActivity { 


private RelativeLayout container; 


/沙沙 
* 用 于 判断 是 否 可 以 跳 过 广告 ， 进 入 MainActivity 
举人 

private boolean canJump 


GOverride 
protected void onCreate(Bundle savedInstanceState) { 
super.onCreate(savedInstanceState); 
setContentView(R.layout.activity splash); 
container = (RelativeLayout) findViewById(R.id.container); 
// 进行 运行 时 权限 处 理 
List<String> permissionList = new ArrayList<>(); 
if (ContextCompat.checkSelfPermission(this, Manifest.permission.READ PHONE_ 
STATE) != PackageManager.PERMISSION GRANTED) { 
permissionList.add(Manifest.permission.READ PHONE STATE); 
} 
if (ContextCompat.checkSelfPermission(this, Manifest.permission.ACCESS 
COARSE LOCATION) != PackageManager.PERMISSION GRANTED) { 
permissionList.add(Manifest.permission.ACCESS COARSE LOCATION); 
} 
if (ContextCompat.checkSelfPermission(this, Manifest.permission.WRITE 
EXTERNAL STORAGE) != PackageManager.PERMISSION GRANTED) { 
permissionList.add(Manifest.permission.WRITE EXTERNAL STORAGE); 
} 
if (!permissionList,.isEmpty()) { 
String [] permissions = permissionList.toArray(new String[permissionList. 
size()]); 
ActivityCompat.requestPermissions(this, permissions, 1); 
} else { 
requestAds (); 
} 
} 


/沙沙 
* 请 求 开 屏 广告 
A 
private void requestAds() { 
String appId = "1105585573"; 
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String adId = "4010212448179536"; 
new SplashAD(this, container, appId, adId, new SplashADListener() { 
@Override 
public void onADDismissed() { 
// 广告 显示 完毕 
forward(); 
} 


@Override 

public void onNoAD(int i) { 
// 广告 加 载 失败 
forward(); 

} 


@Override 
public void onADPresent() { 
// 广告 加 载 成 功 


} 
@Override 
public void onADClicked() { 
// 广告 被 点 击 
} 
}); 
} 
@Override 


protected void onPause() { 
super.onPause() ; 
canJump = false; 


} 


@Override 
protected void onResume() { 
super.onResume(); 
if (canJump) { 
forward(); 
} 
canJump = true; 


} 


private void forward() { 
if (canJump) { 
// 跳 转 到 MainActivity 
Intent intent = new Intent(this, MainActivity.class); 
startActivity(intent); 


finish(); 
} else { 
canJump = true; 
} 
} 
@Override 


public void onRequestPermissionsResult(int requestCode, String[] permissions, 
int[] grantResults) { 
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switch (requestCode) { 
case 1: 
if (grantResults.length > 0) { 
for (int result : grantResults) { 
if (result != PackageManager.PERMISSION GRANTED) { 
Toast.makeText (this，, "必须 同意 所 有 权限 才能 使 用 本 程序 "， 
Toast.LENGTH SHORT).show(); 
finish(); 
return; 


} 


} 
requestAds(); 

} else { 
Toast.makeText(this,，" 发 生 未 知 错误 "，Toast.LENGTH SHORT) .show(); 
finish(); 

} 

break; 

default: 


} 


可 以 看 到 ,在 onCreate() 方 法 中 ， 我 们 先是 获取 到 了 RelativeLayout 的 实例 ， 紧 接着 就 开 
台 进行 运行 时 权限 处 理 。 由 于 这 里 也 是 需要 在 运行 时 一 次 性 申请 多 个 权限 ， 因 此 采用 了 和 11.3.2 
小 节 同 样 的 写法 ， 相 信 你 一 定 不 会 陌生 吧 。 

当 用 户 同意 了 所 有 的 权限 申请 之 后 ， 就 会 调用 requestAds ( ) 方 法 来 请 求 广告 数据 。 在 
requestAds() 方 法 中 我 们 先是 定义 了 appId 和 adId 这 两 个 变量 ， 它 们 的 值 就 是 在 腾讯 广告 联 
盟 后 台 生 成 的 应 用 ID 和 广告 位 ID ， 然 后 创建 SplashAD 的 实例 来 获取 广告 数据 。SplashAD 的 构 
造 函数 接收 $ 个 参数 ， 第 1 个 参数 是 当前 活动 的 实例 ， 第 2 个 参数 是 RelativeLayout 的 实例 ， 第 
3 个 参数 是 应 用 包 , 第 4 个 参数 是 广告 位 ID , 相信 前 4 个 参数 都 没什么 需要 解释 的 。 第 5 个 参数 
是 一 个 SplashADListener 的 实例 ， 用 于 监听 广告 数据 的 回调 。 其 中 onADDismissed() 方 法 会 在 
广告 显示 完毕 时 回调 ，onNoAD ( ) 方 法 会 在 广告 加 载 失 败 时 回调 ，onADPresent ( ) 方 法 会 在 广告 
加 载 成 功 时 回调 , onADCLicked ( ) 方 法 会 在 广告 被 点 击 时 回调 。 当 广告 显示 完毕 或 者 广告 加 载 失 
败 时 ， 我 们 调用 forward() 方 法 跳 转 到 MainActivity， 并 将 当前 活动 关闭 即 可 。 

另外 注意 这 里 还 使 用 了 一 个 canJump 变量 用 于 对 活动 跳 转 进行 控制 。 这 是 因为 如 果 用 户 点 
击 了 广告 , 会 启动 一 个 新 的 活动 来 展示 广告 的 详细 内 容 , 这 个 时 候 即使 回调 了 onADDismissed() 
方法 ,显然 也 不 应 该 启动 MainActivity, 因 此 我 们 在 onPause() 方 法 中 将 canJump 设 置 成 了 false。 
然后 在 forward() 方 法 中 发 现 canJump 是 false, 因此 不 会 进行 跳 转 , 但 是 会 将 canJump 设置 成 
true。 最 后 ， 当 用 户 看 完了 广告 回 到 SplashActivity 时 ，onResume ( ) 方 法 将 会 执行 ， 这 个 时 候 发 
现 canJump 是 true， 因 此 就 会 调用 forward ( ) 方 法 来 启动 MainActivity。 

整体 流程 大 概 就 是 这 个 样子 了 ， 接 下 来 我 们 还 需要 将 主 活动 设置 成 SplashActivity 而 不 再 是 
MainActivity， 否 则 广告 界面 将 无 法 得 到 展示 。 修 改 AndroidManifestxml 中 的 代码 ， 如 下 所 示 : 


[ 
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<manifest xmlns:android="http://schemas.android.com/apk/res/android" 
package="com.coolweather.android"> 


<application 
android:name="org.litepal.LitePalApplication" 
android:allowBackup="true" 
android:icon="Gmipmap/Logo" 
android:label="@string/app_name" 
android:supportsRtl="true" 
android:theme="@style/AppTheme"> 
<activity android:name=".MainActivity"> 
</activity> 
<activity android:name=".SplashActivity"> 
<intent-filter> 
<action android:name="android.intent.action.MAIN" /> 
<category android:name="android.intent.category.LAUNCHER" /> 
</intent-filter> 
</activity> 


</application> 
</manifest> 
这 样 我 们 就 将 广告 SDK 全 部 对 接 完成 了 ， 现 在 可 以 重新 运行 一 下 程序 来 看 一 看 效果 。 不 过 
需要 注意 , 广告 在 模拟 器 上 是 不 会 显示 的 , 我 们 要 用 真正 的 手机 测试 才 行 。 程 序 启动 后 首先 会 弹 
出 运行 时 权限 的 申请 对 话 框 ， 全 部 都 点 击 允许 之 后 就 能 看 到 广告 数据 了 ， 如 图 15.44 所 示 。 


| 
| ih 
lh) 


| 
| 
[遇见 你 ， “家” 往 


情 深 
0 


图 15.44 ”显示 广告 数据 


开 屏 广告 会 持续 5 秒 钟 时 间 ， 然 后 就 会 自动 跳 转 到 MainActivity 中 ,后 面 的 流程 就 和 之 前 是 
完全 一 样 的 了 。 
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15.4.4 重新 发 布 应 用 程序 


现在 我 们 已 经 成 功 在 酷 欧 天 气 中 接 入 了 广告 功能 , 那么 是 时 候 将 这 个 新 版 本 更 新 到 360 应 用 
商店 上 了 。 

由 于 即将 发 布 的 会 是 新 一 版 的 酷 欧 天 气 , 因此 在 生成 安装 包 之 前 还 需要 修改 一 下 应 用 程序 的 
版 本 号 信息 。 编 辑 app/build.gradle 文件 ， 如 下 所 示 : 


android { 

compileSdkVersion 24 

buildToolsVersion "24.0.2" 

defaultConfig { 
applicationId "com.coolweather.android" 
minSdkVersion 15 
targetSdkVersion 24 
versionCode 2 
versionName "1.1" 


} 

可 以 看 到 ， 这 里 将 versionCode 改 成 了 2，versionName 改 成 了 1.1。 需 要 注意 的 是 ， 每 个 版 
本 的 versionCode 和 versionName 都 不 能 和 其 他 版 本 相同 ， 且 新 版 应 用 的 版 本 号 必须 大 于 老 版 应 
用 的 版 本 号 。 

接 下 来 我 们 就 可 以 使 用 在 15.1 节 学 习 的 技术 来 生成 新 的 APK 文件 ， 具 体 的 步 又 就 不 再 重复 
介绍 了 ， 最 终 会 生成 一 个 新 的 app-release.apk 文件 ， 下 面 我 们 将 它 重 新 发 布 到 360 应 用 商店 。 

打开 360 开发 者 后 台 的 管理 中 心 页 面 , 然后 点 击 酷 欧 天 气 的 更 新 管理 按钮 , 如 图 15.45 所 示 。 


酷 欧 天 气 姓 
安检 结果 : 通过 查看 详情 


veathner J ] 


名 编辑 与 更 新 
图 15.45 ”更 新 酷 欧 天 气 
点 击 编辑 与 更 新 按钮 ， 就 能 上 传 新 的 APK 文件 了 。 注 意 上 传 之 后 仍然 会 提醒 应 用 的 安全 系 
数 较 低 ， 我 们 只 需要 使 用 和 之 前 同样 的 方式 进行 加 固 就 可 以 了 。 
另外 , 由 于 新 版 的 酷 欧 天 气 中 增加 了 一 些 敏 感 隐私 权限 , 因此 我 们 还 需要 在 这 一 项 上 面 做 出 
说 明 ， 如 图 15.46 所 示 。 


应 用 内 具有 广告 功能 ， 需 获取 用 户 的 粗略 位 置 来 显示 更 加 合理 的 广 © 
告 。 


图 15.46 ”对 敏感 隐私 权限 进行 说 明 

现在 只 需要 点 击 页 面 最 下 方 的 提交 审核 按钮 , 新 版 本 的 酷 欧 天 气 就 发 布 成 功 了 ， 当 然 还 需要 
通过 360 的 审核 才 行 。 以 后 每 当 有 用 户 观看 或 点 击 了 应 用 程序 中 的 广告 时 , 我 们 就 能 真正 地 得 到 
收益 。 在 腾讯 广告 联盟 的 后 台 管 理 界面 可 以 查看 到 每 天 的 收益 情况 ， 如 图 15.47 所 示 。 


昨日 预 估 收 益 近 7 日 收益 本 月 累计 收益 账号 总 收益 


图 15.47 查看 广告 收益 情况 


你 的 应 用 越 成 功 , 所 获得 的 广告 收益 也 会 越 多 , 因此 赶快 去 编写 更 多 优秀 的 应 用 程序 来 赚 更 
多 的 钱 吧 ， 相 信 通 过 整 本 书 的 学 习 ， 你 已 经 有 足够 的 能 力 做 到 了 ! 


15.5 ”结束 语 


就 这 样 ， 本 书 所 有 的 内 容 你 都 学 完了 ， 现 在 你 已 经 成 功 毕 业 ， 并且 成 为 了 一 名 合格 的 Android 
开发 者 。 但 是 如 果 想 要 成 为 一 名 出 色 的 Android 开发 者 ， 光 靠 本 书 中 的 这 些 理论 知识 以 及 少量 的 实 
践 还 是 不 够 的 ， 你 需要 真正 步 人 到 工作 岗位 当中 ， 通 过 更 多 的 项 目 实战 来 不 断 地 历练 和 提升 自己 。 

踪 叫 了 整 本 书 的 话 , 但 是 到 了 最 后 却 不 知道 该 说 点 什么 好 , 我 不 想 说 我 能 教 你 的 就 只 有 这 些 
了 ， 因 为 实际 上 我 想 教 你 或 者 和 你 一 起 探讨 的 内 容 还 有 很 多 很 多 , 不 过 限于 篇 幅 的 原因 ,本 书 的 
内 容 就 只 能 到 此 为 止 了 。 但 我 会 长 期 在 博客 和 微 信 公众 号 上 面 分 享 更 多 Android 相关 的 技术 文章 ， 


如 果 感 兴趣 的 话 ， 可 以 到 我 的 博客 和 公众 号 中 继续 学 习 。 当 然 ， 如 果 对 本 书 中 的 内 容 有 疑问 , 也 
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如 果 您 对 本 书 内 容 有 疑问 ， 可 发 邮件 至 contact@turingbook.com， 会 有 编辑 或 作 
译 者 协助 答疑 。 也 可 访问 图 灵 社 区 ， 参 与 本 书 讨论 。 
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